动手前的五分钟
用一个你拥有的 git 仓库，工作区干净，当前在普通功能分支。不要选生产配置目录。
先能自己跑一项检查：测试、类型检查或 lint。Agent 需要一个你也看得懂的完成标准。
仓库很大时，用练习分支或一个你自己的小项目。这一课练的是闭环，不是业务域。
- git status 是干净的。
- 不在主分支上乱试也可以，但要能回退。
- 准备好一条验证命令。
把任务说成可验收的句子
坏任务：把代码变好。好任务：在这个测试文件里补一个失败用例，再改实现让它通过，不要动无关目录。
写清范围：哪些路径能改，哪些命令能跑，什么叫完成。范围是给你自己看的，也是给 Agent 看的。
若已有 AGENTS.md，点名让它先读。没有的话，下一章再写。先靠这一次提示里的约束也能做完第一课。
一段可改写的提示：在点名的测试文件里补一个失败用例，只改应该让它通过的实现，跑你的测试命令，不要提交也不要推送。
- 点名文件或目录。
- 给出验证命令。
- 写上不要提交密钥、不要推远程。
从终端开始这个任务
在仓库根目录启动文档里的 Codex 会话命令。若文档有非交互调用，可以用来丢一条提示，但文件仍要你自己看。
再留一个终端跑 git status 和测试命令。不要让 Agent 成为唯一的成功汇报。
- 在仓库根，除非任务就在子包。
- 第二个终端给 git 和测试。
- 若要重试，把提示词放进文件再复制。
看 diff，而不是看自信的总结
Agent 很会说“已完成”。你要看改动的文件列表和具体 hunk。多出来的重构，默认先丢掉。
用你自己的命令再跑一遍。测试绿了但你看不懂的改动，仍然算未完成。
盯着顺手重构：重命名、新格式化工具、额外依赖。你没要的就回退。
- 列出改动文件。
- 读每个 hunk。
- 跑你自己的验证命令。
- 不要的改动就回退。
第二轮怎么收
第一轮常会漏测试或改太大。第二轮只说漏了什么，不要把任务重写成史诗。
两轮之后仍在扩散，停。要么你范围太大，要么仓库缺少说明书。去写 AGENTS.md。
紧的第二轮提示会点名文件和失败断言。一句再试试，第三个目录就会出现。
- 一次只修一个失败原因。
- 连续两轮扩散就停。
第一课失败也算学过
常见失败：登录过期、PATH 指错、仓库太大却不给范围。这些去排错章，不要在这里加 MCP。
Agent 改了不该改的文件，把 diff 留下来当反面教材，写进即将出现的 AGENTS.md。
若客户端提供撤销，可以用，但仍然要跑 git。
- 登录失败：回到安装章。
- 乱改文件：收紧路径，写禁区。
第一课常见错
只接受总结时，这一课就失败了。我加了测试不是测试文件。打开文件。
不要因为第一句提示含糊就去叠 MCP。应该收紧提示。
- 在脏的 git 工作区开始。
- 为了省时间让它提交。
- 只看聊天，不看 diff。
第一课清单
完成意味着你能解释每个 hunk，或者已经回退了讲不清的部分。
- 干净的 git status，分支可以丢掉。
- 提示里有路径、命令和禁区。
- 你自己的验证命令，由你来跑。
- 多余的改动回退。
- 若它跑偏了，留一条反面教材给 AGENTS.md。
下一步：写下它本该读到的说明书
若同一条禁区说了两遍，那句话属于 AGENTS.md。
若任务根本没开始，去排错。不要打开技能章换办法。