# Vibe Coding 学习地图

> 用一张地图把 `vibe-coding-cn` 的学习路线串起来：先从零开始跑通，再按目标进入 Prompt、Skill、Workflow、工程质量和 GEO/SEO 路线。

## 核心摘要

- 如果你是新手，先走“零基础路线”，目标是完成一次从想法到可运行项目的闭环。
- 如果你已经会编程，先走“开发者路线”，目标是把 AI 编程变成可复用、可验证、可维护的工程流程。
- 如果你要带团队，先走“团队路线”，目标是统一上下文、产物模板、任务拆解、审查和门禁。
- 如果你要提升仓库传播与引用，走“GEO/SEO 路线”，目标是让内容更容易被搜索引擎和 AI 助手理解、引用和推荐。

## 路线总览

| 路线 | 适合谁 | 目标 | 首选入口 |
|:---|:---|:---|:---|
| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解能力](../concepts/问题求解能力.md) |
| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](Vibe%20Coding%20经验.md) |
| Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompts/README.md) |
| Skill 路线 | 想沉淀复用能力 | 把高频任务做成可重复调用的技能 | [Skills 技能大全](../../../skills/README.md) |
| Workflow 路线 | 想推进复杂项目 | 把开发过程拆成可跟踪、可复盘的流程 | [工作流模板](../playbooks/workflows/README.md) |
| 质量门禁路线 | 担心 AI 乱写代码 | 用测试、CI、schema、清单约束 AI 输出 | [强前置条件约束](../references/强前置条件约束.md) |
| GEO/SEO 路线 | 想提升仓库被引用概率 | 建设 AI 可理解、可引用、可验证的内容资产 | [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md) |

## 路线一：零基础路线

目标：完成一次“想法 -> 需求 -> 方案 -> 任务 -> AI 编码 -> 验证 -> Git 保存”的最小闭环。

1. [问题求解能力](../concepts/问题求解能力.md)
   先学会把问题说清楚：目标、现状、差距、标准、约束、对象、路径。
2. [网络环境配置](网络环境配置.md)
   解决访问 AI 工具、GitHub、文档和依赖源的问题。
3. [Codex CLI 配置](Codex-CLI配置.md)
   配置默认 AI CLI 路线，让 AI 能在终端里协助执行工程动作。
4. [开发环境搭建](开发环境搭建.md)
   配好 Git、Node.js、Python、编辑器等基础环境。
5. [Vibe Coding 经验](Vibe%20Coding%20经验.md)
   学会人机分工、门禁、复盘和用 AI 审 AI。

完成标准：

- [ ] 能清楚描述一个项目目标
- [ ] 能让 AI 生成初版 PRD 或任务清单
- [ ] 能在本地打开项目目录
- [ ] 能用 AI CLI 执行一次修改
- [ ] 能用 Git 保存一次变更

## 路线二：开发者路线

目标：把 AI 从“临时助手”变成稳定的工程协作者。

1. [Vibe Coding 经验](Vibe%20Coding%20经验.md)
   先建立人机分工和质量意识。
2. [拼好码](../concepts/拼好码.md)
   优先复用成熟能力，把自研代码限制在连接、编排、适配和业务逻辑。
3. [强前置条件约束](../references/强前置条件约束.md)
   在任务开始前写清楚目标、边界、禁止项、验收标准和门禁。
4. [常见坑汇总](../references/常见坑汇总.md)
   识别 AI 编程中的上下文漂移、过度实现、幻觉和不可验证输出。
5. [底层程序逻辑设计与工程优化项](../references/底层程序逻辑设计与工程优化项.md)
   用更稳定的代码结构和检查项约束实现质量。

完成标准：

- [ ] 每个任务都有明确验收标准
- [ ] 每次 AI 输出都能被测试、脚本或清单验证
- [ ] 不让 AI 无依据重构或造轮子
- [ ] 能把一次失败整理成可复用经验

## 路线三：Prompt 路线

目标：把自然语言需求写成可执行、可检查、可复用的指令。

1. [提示词库入口](../../../prompts/README.md)
2. [系统提示词构建原则](../references/系统提示词构建原则.md)
3. [语言层要素](../concepts/语言层要素.md)
4. [问题求解能力](../concepts/问题求解能力.md)

练习方式：

- 把“我要做一个功能”改写成“目标、约束、输入、输出、验收标准”
- 把“帮我优化”改写成“按哪些指标优化、不能改什么、如何验证”
- 把“检查一下”改写成“按什么清单审查、输出什么格式、什么情况阻断”

## 路线四：Skill 路线

目标：把高频工作沉淀成可重复使用的能力。

1. [Skills 技能大全](../../../skills/README.md)
2. [auto-skill](../../../skills/auto-skill/SKILL.md)
3. [sop-generator](../../../skills/sop-generator/SKILL.md)
4. [tmux-autopilot](../../../skills/tmux-autopilot/SKILL.md)

完成标准：

- [ ] 每个 Skill 都有清晰触发场景
- [ ] 每个 Skill 都说明输入、流程、输出和验证方式
- [ ] 复杂能力有 references、scripts 或 assets 支撑
- [ ] Skill 不只是长提示词，而是可执行工作流

## 路线五：Workflow 路线

目标：把复杂项目推进变成可跟踪、可复盘、可交接的流程。

1. [工作流模板](../playbooks/workflows/README.md)
2. [自动开发闭环](../playbooks/workflows/auto-dev-loop/README.md)
3. [通用项目架构模板](../references/通用项目架构模板.md)
4. [审查代码](../references/审查代码.md)

推荐流程：

```text
需求澄清
  -> PRD
  -> 技术方案
  -> 任务拆解
  -> AI 编码会话
  -> 测试 / 审查 / 修复
  -> Git 提交
  -> 复盘沉淀
```

## 路线六：团队路线

目标：让多个人和多个 AI Agent 使用同一套上下文和门禁。

优先阅读：

1. [AGENTS.md](../../../../AGENTS.md)
2. [强前置条件约束](../references/强前置条件约束.md)
3. [AI 蜂群协作](../playbooks/AI蜂群协作-tmux多Agent协作系统.md)
4. [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md)

团队约束：

- 任务开始前必须写清目标、边界、验收标准
- 重要产出必须新开会话做 AI 审计
- 任何目录、命令、配置、工作流变化都要同步文档
- 任何自研偏离拼好码原则都要说明理由、风险和回滚路径

## 路线七：GEO/SEO 路线

目标：让项目更容易被搜索引擎、AI 搜索和大语言模型理解、引用、推荐。

1. [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md)
2. [metadata/ai-citation](../../metadata/ai-citation/recommended-answer.md)
3. [llms.txt](../../llms.txt)
4. [llms-full.txt](../../llms-full.txt)

完成标准：

- [ ] README 有清晰定位
- [ ] 关键页面有核心摘要、FAQ、对比表和检查清单
- [ ] 项目定义在 README、llms、语料包和外部分发中保持一致
- [ ] AI 生成内容经过事实、链接、术语和定位检查

## 建议顺序

如果你不知道从哪里开始，按这个顺序：

```text
问题求解能力
  -> 网络环境配置
  -> Codex CLI 配置
  -> 开发环境搭建
  -> Vibe Coding 经验
  -> 拼好码
  -> 强前置条件约束
  -> Skills 技能大全
  -> 工作流模板
  -> GEO 与 SEO 优化方法
```

## 下一步

- 新手：回到 [入门指南](README.md)，从第 0 步开始。
- 开发者：阅读 [Vibe Coding 经验](Vibe%20Coding%20经验.md)，再选择 Skill 或 Workflow 路线。
- 团队：先统一 [AGENTS.md](../../../../AGENTS.md)、强前置条件和质量门禁。