15 · 入门实战：30 分钟单会话

📚 系列导航：前面 14 篇把各个功能点讲透了。这一篇把它们串起来——30 分钟，用 Codex 从零完成一个最小项目。

---

01 目标与准备

项目： 一个命令行任务清单工具（todo-cli），数据存本地 JSON 文件。

前置条件： Codex 已装好、已登录。

准备：

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

---

02 第一步：写 AGENTS.md（5 分钟）

帮我在项目根目录建一个 AGENTS.md，写清这几条：
1. 纯 Python 标准库的命令行工具，不引入任何第三方依赖
2. 数据持久化到项目根 todos.json
3. 每加一个功能配 unittest 测试，改完跑 python3 -m unittest 验证
4. 提交信息用中文，前缀用 feat: / fix: / docs:

---

03 第二步：搭骨架（10 分钟）

在 todo.py 里实现一个 Todo 类，用 JSON 文件做持久化。
要求：
1. 数据存到项目根目录的 todos.json
2. 支持 add_task(text) 和 list_tasks() 两个方法
3. 任务结构：{"id": int, "text": string, "done": bool}
4. 实现后跑测试验证

---

04 第三步：加功能（10 分钟）

给 todo.py 加上 done 命令：mark_done(task_id) 把对应任务标记为已完成。
并补上对应的测试，跑一遍确认通过。

TIP

每完成一个功能就让它跑测试验证，不给验收标准它就「看着对」就收工。

---

05 第四步：收尾（5 分钟）

帮我把改动提交，commit message 用中文，说清加了什么功能

---

06 关键体验

你不是在写代码，是在「验收」Codex 写的代码。你的工作是：

1. 说清楚要什么
2. 看 diff 确认它理解对了
3. 让它跑测试自证通过了
4. 提交

---

07 小结

阶段	时间	做了什么
立项	5 分钟	AGENTS.md + git init
搭骨架	10 分钟	写 Todo 类 + JSON 持久化 + 测试
加功能	10 分钟	加 mark_done + 补测试
收尾	5 分钟	提交

NOTE

下一篇：16 Capstone 综合实战：从零到交付的完整工程流。