把进阶能力串成一个真实项目
前四块（多文件、代码审查、Git 工作流、任务规划）单看都会了。这一节把它们组合成一个端到端的中大型项目开发，看它们怎么协作。
目标任务：在真实项目里，跨多个文件实现一个新功能，走完 Git + 审查的完整流程。
file-lib 养大，现在到了「总攻」时刻：端到端完成 file-lib 的 v2.0「文件监听（watch）」功能。从建分支、拆任务、跨文件实现、审查修复、到 Git 提交 + PR，把学过的五个能力在这一节里完整串一遍。这是 file-lib 的收官之战，也是你第一次独立指挥一次中大型开发。第 1 步：建分支，隔离开发
先给这次开发开一个干净的分支：
git checkout -b feature/watch
让 Codex 只在 feature/watch 分支干活，主干保持稳定。
第 2 步：拆解任务（任务规划）
用上一模块的拆解法，把「文件监听」拆成步骤：
目标：file-lib v2.0 支持 watch 文件监听
1. 定义监听 API（事件类型、回调签名）
2. 核心：实现监听引擎 lib/watch.js（依赖 API 定义）
3. CLI：接入 --watch 参数（依赖引擎）
4. 测试：覆盖新建/修改/删除、目录不存在
顺序：1 → 2 → 3 → 4
每步一个子任务，逐步推进。这就是上一节拆好的规划，直接拿来用。
第 3 步：跨文件实现（多文件 + 上下文管理）
实现时，给 Codex 划清范围、管理上下文：
【范围】只改 lib/watch.js（新建）和 bin/cli.js（加 --watch）
【约束】不要动其他模块的导出签名
第 2 步先做监听引擎，我只给你 lib/watch.js 相关文件。
分阶段喂 + 划清范围，避免上下文爆炸、范围失控。每完成一个子任务，用 git status + git diff 过一遍眼，确认没碰禁区文件。
第 4 步：代码审查 + 修复（审查落地）
实现完，让 Codex 审查自己的改动，再修复：
审查这次改动，重点看边界和性能，按「必须改/建议改/可不改」输出。
然后把「必须改」的修复掉，跑测试。
审出问题 → 修复 → 验证，落地闭环。对 file-lib 的 watch 功能，重点审查方向：
审查重点：
- 目录不存在时会不会崩溃（边界）
- 大量文件变化时监听会不会漏事件或内存增长（性能）
- 回调签名是否和 API 定义一致（调用链）
按「必须改 / 建议改 / 可不改」输出，必须改的直接修。
第 5 步：Git 提交 + PR（Git 工作流）
审查通过后，提交并走 PR：
git add lib/watch.js bin/cli.js test/watch.test.js
git commit -m "feat(watch): 新增文件监听功能"
git push -u origin feature/watch
# 提 PR，评审通过后合并
Codex 的活，全程走分支、审查、PR，有记录可回滚。注意这里逐个加文件，而不是 git add .，避免把无关改动一起提交进去。
全程回顾这套组合
建分支（隔离）
→ 拆任务（规划）
→ 跨文件实现 + 管上下文（多文件）
→ 审查 + 修复（质量）
→ 提交 + PR（Git 流程）
五个进阶能力，串成一条完整的开发流水线。这就是端到端——不是五个技能各用一次，而是它们协同工作：规划决定做什么，多文件技巧保证怎么做不乱，审查守住质量，Git 全程留痕可控。
feature/watch 分支并按上节的拆解规划逐步推进（API → 引擎 → CLI → 测试）；实现时用「范围 + 分阶段喂」管好上下文，每步用 git diff 过眼；全部实现后用「必须改/建议改/可不改」审查并修复，跑通测试后提交 + 推远端 + 提 PR。②怎么判断做对了：五个能力都实际用上了（分支 / 拆解 / 跨文件 / 审查 / PR）、main 全程稳定、watch 功能能监听文件新增 / 修改 / 删除、PR 里有清晰提交信息和评审记录。③卡住了怎么办：如果中途上下文爆了，开新会话带上「v2.0 拆解规划」继续；如果合并 PR 时有冲突，参照冲突解决一节的步骤让 Codex 分析、你裁决；如果某步卡太久，回退到上一个稳定提交重新走那一步。常见坑：五步「串」不起来，做成一锅粥
端到端最大的坑不是哪个单点不会，而是五步衔接混乱：做着做着忘了自己在哪个阶段，比如「还没拆完就跑去写代码」「还没审就提交」「提交了才想起没建分支」。结果整个流程乱成一锅粥，该有的安全网全漏了。
避坑办法：给自己一个「当前阶段」的意识，每完成一步就明确宣布进入下一步：
我现在在【第 2 步：拆解任务】。
拆解完成，进入【第 3 步：跨文件实现】之前，先 git status 确认工作区干净。
甚至可以每步开始都让 Codex 自报：
我们按这五个阶段走：①建分支 ②拆任务 ③跨文件实现 ④审查修复 ⑤提交PR。
现在告诉我：当前你处于哪个阶段？下一步是什么？
把「当前阶段」挂在嘴边，五步才能真正串成一条流水线。 否则每一个能力单看都对，合起来却处处脱节。
小结
这一节把进阶能力组合成了完整的中大型项目开发流程：
- 建分支隔离，让 Codex 大胆干
- 拆解任务，逐步推进
- 跨文件实现时管好范围与上下文
- 审查 + 修复落地
- Git 提交 + PR，全程可控可回滚
下一节，复盘这次项目并提升质量。