Skip to content

16 · Capstone 综合实战

📚 系列导航:上一篇 15 入门实战 用单会话跑通了一个最小项目。这一篇把前面所有零件拧成一股绳——从零到提交,完整走一遍。


01 立靶子:两分钟造项目

bash
mkdir todo-cli && cd todo-cli && git init

todo.py,一个命令行待办工具,能 add 和 list。然后 git commit -m "init"


02 写须知:AGENTS.md

text
帮我在项目根目录建一个 AGENTS.md,写清:
1. 纯 Python 标准库,无第三方依赖
2. 运行:`python todo.py add <内容>` / `python todo.py list`
3. 新功能保持命令行风格
4. 改完跑 `python -m unittest`

03 派活:四件套

text
给 todo.py 加一个「删除待办」功能。
目标:支持 `python todo.py done <序号>`,按 list 显示的序号删除对应待办。
范围:只改 todo.py 和测试文件;不要动命令行风格,不要引第三方包。
约束:序号从 1 开始;越界或非数字时友好提示。
验收:用 unittest 覆盖正常删除、越界、非数字三种情况,`python -m unittest` 全绿。

04 设权限:workspace-write + on-request

bash
codex --sandbox workspace-write --ask-for-approval on-request

05 自验证

Codex 改完后让它跑测试:

text
跑一下 python -m unittest,把结果贴出来

06 提交

text
把这次改动提交一下:先看 git status 和 git diff,再写一条中文提交信息,
前缀用 feat:,提交前把变更和信息列给我确认。

07 回头看全链路

步骤对应篇
立靶子本篇
写须知09 AGENTS.md
派活05 提示词四件套
设权限07 权限与安全
自验证05 提示词四件套
提交14 Git 工作流

08 小结

须知 → 派活 → 权限 → 自验证 → 提交,这条顺序是真实开发的自然节奏。前面每一篇都是这条流水线上的一个工位,串起来才是「会用 Codex」。

NOTE

下一篇17 最佳实践七条法则:把零散的好习惯攒成一套能照着做的心法。

Codex 实战手册