34 · 综合实战:从需求到 Git 提交
用一个 TODO 工具功能需求,串起项目规则、计划、编码、测试、差异审查和 Git 提交,展示完整可复用的交付流程。
学了这么多,是时候把整个流程串起来跑一遍了。这一篇用一个「给 TODO 工具加个功能」的需求,走一遍完整交付。
第一步「项目规则」:先写好(或读好)AGENTS.md,把项目约定、技术栈、禁忌都讲清楚。地基不牢,后面全晃。
第二步「计划」:别上来就写代码,先让它出个实现计划——要改哪些文件、分几步、每步做什么。计划你认可了再动手。
第三步「编码」:按计划让它实现。小步走,每步都看 diff,别让它一口气改一大堆。
第四步「测试」:功能写完,让它补测试、跑测试,确认没破坏原有行为。绿了才算数。
第五步「差异审查」:整体再过一遍所有改动,确认符合预期、没有夹带私货。
第六步「Git 提交」:让它整理改动、写清楚的提交信息,完成提交。
这六步,就是我们前面所有内容的一次合练:AGENTS.md(规则)、提示词写法(计划)、工作流(编码+测试)、权限(审查)、Git 集成(提交)。
这个流程是可复用的:换成任何真实需求,照这六步走,都不会跑偏。它就是你「稳定交付」的母版。
到这一篇,你已经从「会用 Codex 做小事」走到了「能用一个可靠的流程交付完整功能」。剩下的,就是在真实项目里反复练、反复优化。
一个自查清单:当你读完这一篇时,可以问自己三个问题——它解决的是什么具体问题?我当前的工作/学习里有没有这个场景?下一步我该学哪一篇?把这三个问题答清楚,你就知道自己有没有真正吃透。
五分钟练习:① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来,你对这一篇的理解会深 3 倍。
与其他篇的关系:这一篇是本组的基础。如果你跳过了前面几篇,建议先回去看,否则这里有些概念可能看着突兀。如果都看过了,那你可以直接进入更后面的实战环节,把这里学到的东西用上。
一页速览:如果只能记三件事,① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。