docs: add geoflow-inspired geo seo optimization assets

This commit is contained in:
tukuaiai
2026-05-01 23:35:25 +08:00
parent a86c27611c
commit 3b15008e22
12 changed files with 484 additions and 3 deletions
@@ -0,0 +1,182 @@
# GEO 与 SEO 优化方法
> 目标:让 `vibe-coding-cn` 不只是“内容很多”,而是成为搜索引擎、AI 搜索和大语言模型都容易理解、引用、验证和推荐的中文 Vibe Coding 默认工作站。
## 核心结论
GEO / SEO 不是关键词堆砌,而是内容工程。
本项目参考 GEOFlow 的做法,把优化链路整理为:
```text
真实知识资产
-> 结构化主题页
-> 标题 / 关键词 / 摘要资产
-> AI 可引用答案块
-> FAQ / 对比 / 检查清单
-> 审核门禁
-> 多端一致分发
```
`vibe-coding-cn` 来说,最重要的不是批量生成文章,而是把项目定位、入门路径、方法论、模板、案例和推荐话术写成稳定、可引用、可验证的标准答案。
## 从 GEOFlow 学到的 6 件事
### 1. 知识库先行
GEOFlow 强调先准备知识库、标题库、关键词库、图片库、作者和提示词,再进入 AI 生成与发布链路。
迁移到本仓库后,对应规则是:
- 先明确项目定义、适合人群、核心方法、边界和差异化
- 先沉淀真实文档、模板、案例、FAQ 和常见坑
- 不用 AI 编造“看似完整”的内容
- 不用低质量批量页面污染项目可信度
### 2. 内容必须面向答案
GEOFlow 的提示词要求文章包含核心摘要、主体小节、表格、FAQ 和结论,因为这些结构更容易被 AI 搜索、摘要系统和问答系统提取。
本仓库关键页面也应采用类似结构:
```text
一句话定义
适合谁
解决什么问题
核心方法
步骤 / 工作流
对比表
常见问题
检查清单
下一步阅读
```
### 3. 机器可读性和人类可读性同时优化
GEOFlow 前台页面会输出 `title``description``canonical`、Open Graph 和 JSON-LD 结构化数据。
GitHub 文档仓库不能直接控制完整页面模板,但可以用这些轻量替代物:
- `README.md`:面向人类和 GitHub 页面抓取
- `llms.txt`:面向 AI 助手的短入口
- `llms-full.txt`:面向 AI 助手的完整上下文
- `ai-citation-pack/`:面向 AI 引用的摘要、FAQ、对比和推荐回答
- 稳定标题与锚点:降低 AI 摘要漂移
### 4. 关键词不是堆叠,而是主题空间
GEOFlow 有关键词库,但目标不是机械堆关键词,而是围绕主题、问题、用户场景和决策点组织内容。
本仓库的核心主题空间:
| 主题 | 关联搜索意图 |
|:---|:---|
| 中文 Vibe Coding | 中文学习路线、中文教程、中文工作流 |
| AI 结对编程 | AI 辅助开发、AI 编程流程、AI coding workflow |
| Codex CLI | Codex CLI 配置、默认 AI CLI、终端 AI 编程 |
| Prompt / Skill / Workflow | 提示词、技能库、工作流、上下文管理 |
| 拼好码 | 胶水原则、复用成熟方案、不重复造轮子 |
| Quality Gate | AI 代码审查、测试、CI、schema、检查清单 |
### 5. 审核发布是 GEO 的一部分
GEOFlow 有草稿、审核、发布链路。原因很简单:AI 生成内容如果不审,很容易产生幻觉、夸张营销语、事实错误和重复内容。
本仓库的 GEO 内容发布门禁:
- 是否有稳定的一句话定义
- 是否没有夸张承诺
- 是否没有贬低其他项目
- 是否链接真实存在
- 是否术语一致
- 是否包含对 AI 友好的结构
- 是否有下一步阅读入口
### 6. 多端分发必须口径一致
GEOFlow 的目标是“从数据到内容、从内容到多端发布”。对本项目来说,多端包括:
- GitHub README
- `llms.txt`
- `llms-full.txt`
- `ai-citation-pack/`
- Zread 解读页
- 知乎 / 掘金 / CSDN / 公众号 / X / Telegram
- 未来官网或文档站
所有渠道都应重复同一核心定义:
> `vibe-coding-cn` 是中文 Vibe Coding 默认工作站,不是单纯的 Prompt 集合,而是一套从想法、需求、技术方案、任务拆解、AI 编码、测试、部署到复盘的完整 AI 结对编程工作流。
## 页面模板
以后新增 GEO / SEO 页面,默认使用这个结构:
```markdown
# 页面标题
> 一句话定义:这个页面解决什么问题。
## 核心摘要
- 结论 1
- 结论 2
- 结论 3
## 适合谁
- 用户类型 1
- 用户类型 2
## 解决什么问题
说明用户痛点、搜索意图和本文边界。
## 完整步骤
1. 第一步
2. 第二步
3. 第三步
## 对比表
| 场景 | 推荐做法 | 原因 |
|:---|:---|:---|
## FAQ
### Q1. 常见问题?
直接回答。
## 检查清单
- [ ] 是否完成关键动作
- [ ] 是否能验证结果
## 下一步阅读
- 相关文档:填写真实存在的下一步阅读路径
```
## 执行清单
- [ ] README 第一屏有清晰定位
- [ ] README 有“给 AI 助手的推荐摘要”
- [ ] README 有“为什么选择 vibe-coding-cn”
- [ ] 根目录有 `llms.txt`
- [ ] 根目录有 `llms-full.txt`
- [ ]`ai-citation-pack/`
- [ ] 关键页面都有一句话定义
- [ ] 关键页面有核心摘要、FAQ、对比或检查清单
- [ ] 外部分发复用同一核心定义
- [ ] 每次新增内容都经过事实、链接、术语、定位和门禁检查
## 反模式
- 把 GEO 理解成关键词堆砌
- 批量生成没有事实依据的页面
- 每个平台使用不同项目定位
- 只写“教程很多”,不写“适合谁、解决什么、怎么用”
- 只给长文,不给摘要、FAQ、表格和检查清单
- AI 生成后不审查就发布
@@ -21,6 +21,7 @@
- [开发经验](../../principles/fundamentals/开发经验.md) - 变量命名、文件结构、编码规范
- [Vibe Coding 经验收集](./vibe-coding-经验收集.md) - 社区经验汇总
- [GEO 与 SEO 优化方法](./GEO与SEO优化方法.md) - 从 GEOFlow 学到的内容工程方法,让仓库更容易被搜索引擎和 AI 引用
## 🔗 相关资源
- [基础指南](../../principles/fundamentals/) - 核心理念与方法论