0.1 读者位置：你需要先会什么

本手册默认你已经是开发者，或者至少能在真实项目里完成基本操作。

你应该已经会

能力	最低要求
终端	能进入目录、运行命令、看错误输出
Git	能看 diff、提交、回滚局部改动
项目结构	能读 README、配置文件和目录结构
依赖管理	能安装依赖、理解 lockfile 大概作用
调试	能看 stack trace，知道怎么复现问题
测试	知道测试、lint、typecheck、build 的区别

不会这些，不是不可以学 Vibe Coding，而是不适合直接学这本手册。先补基础，再回来。

本手册面向谁

适合：

• 已有编程基础，想系统学习 AI 辅助开发的人。
• 已经用过网页 GPT / Claude / Gemini，但想进入真实项目。
• 用过 Cursor / Trae / Windsurf，但感觉长任务不稳定的人。
• 想重点学习 Codex 和 Claude Code 共性操作的人。
• 想理解 MCP、skills、AGENTS.md、CLAUDE.md、OpenSpec、Superpowers、GSD、OMC、ECC、Trellis、CCG 这些东西怎么放在一起的人。

不适合：

• 只想让 AI 自动做完全部事情的人。
• 不愿意 review diff 的人。
• 不关心测试和验证的人。
• 把“能跑起来”当成唯一质量标准的人。

你的角色变化

传统开发里，你主要做：

flowchart LR
  A[理解需求] --> B[写代码]
  B --> C[调试]
  C --> D[提交]

Vibe Coding 里，你更多做：

flowchart LR
  A[定义目标] --> B[组织上下文]
  B --> C[设定边界]
  C --> D[委派执行]
  D --> E[验证结果]
  E --> F[沉淀规则]

代码不是不重要，而是你不再需要亲手写每一行。你的价值转移到判断力、上下文组织、质量控制和系统设计上。

自测

如果下面 5 个问题你能回答，适合继续读：

1. 这个项目怎么启动？
2. 这个项目怎么跑测试？
3. Git diff 里哪些改动是 AI 误改？
4. 一个需求里哪些部分不能让 AI 自由发挥？
5. AI 做错一次之后，应该把什么写回规范文件？

答不上来，就先从项目运行、Git、测试和调试基础补起。