普通人 AI 实战手册

Appearance

34 · 综合实战：从零给一个 TODO 小工具加功能、提交一次 ​

前面 33 篇讲了很多功能。 这一篇把它们串成一条真实流程。

目标不是做一个多复杂的产品。 目标是让你体验一次：从需求、规则、派活、验证，到 Git 提交。

TODO 综合实战流程

这次实战只追求一个闭环 ​

不要把 TODO 小工具做成产品。 这次只练完整流程：

  1. 建一个小项目。
  2. 写项目规矩。
  3. 派一个小功能。
  4. 控制权限。
  5. 跑验证。
  6. 看 diff。
  7. 生成提交说明。

功能小没关系，流程完整最重要。

第一次实战只做一个功能 ​

不要把综合实战做成大项目。 第一次只选一个功能：

text
请给 TODO 小工具增加“清空已完成任务”按钮。

范围：
只改实现这个按钮必须修改的文件。

限制：
1. 不做登录
2. 不接数据库
3. 不重做 UI
4. 不引入大型依赖

验收：
1. 有已完成任务时可以清空
2. 未完成任务不受影响
3. 页面能正常打开
4. 最后展示 diff 并说明怎么检查

这就是一个合格的 Codex 实战任务。

01 先把“靶子”立起来：两分钟造一个 TODO 小工具 ​

你需要一个很小的项目。

功能可以很简单：

  1. 添加 TODO。
  2. 勾选完成。
  3. 删除 TODO。
  4. 本地保存。

不要一上来做登录、数据库、支付。

02 第一步：写 AGENTS.md，把项目背景一次交代清 ​

先写项目说明书：

text
请帮我为 TODO 小工具写一份 AGENTS.md 草案。
内容包括：
1. 项目目标
2. 技术栈
3. 常用命令
4. 修改边界
5. 验证方式
先给草案，不要创建文件。

03 第二步：派活：目标 + 范围 + 约束 + 验收，一句说全 ​

示例任务：

text
目标：给 TODO 小工具增加“筛选全部/未完成/已完成”功能。
范围：只修改前端页面和必要状态逻辑。
约束：不要新增依赖，不要改项目结构。
验收：
1. 三个筛选按钮能切换列表
2. 添加和删除 TODO 仍然可用
3. 构建通过

04 第三步：设好权限：让它能改文件、能跑测试，但别放飞 ​

权限建议：

  1. 允许修改项目文件。
  2. 允许运行构建和测试。
  3. 安装依赖前必须确认。
  4. 删除文件前必须确认。
  5. 不允许操作真实账号或服务器。

05 第四步：让它自验证：跑测试，不达标不收工 ​

任务里直接写：

text
修改完成后请运行项目已有检查。
如果构建失败，请先解释原因，再做最小修复。
最后告诉我如何手动验证功能。

不要只看它说“完成”。 要看验证结果。

06 第五步（可选）：什么时候该叫子代理或 MCP 来搭把手 ​

这个小项目通常不需要子代理和 MCP。

只有这些情况才考虑：

  • 需要同时检查安全和测试。
  • 要读外部文档。
  • 要批量处理很多文件。

小白阶段：能不用就不用。

07 最后一步：git 提交：它来打草稿，你来按下确认 ​

让 Codex 帮你整理提交信息：

text
请根据当前改动生成一条 git commit message。
只生成文本，不要提交。

真正提交前，你自己看 diff。

08 回头看整条链：每一步在用哪一篇的本事 ​

这次实战会用到：

  1. AGENTS.md 项目说明书。
  2. 提示词四要素。
  3. 权限和审批。
  4. 日常工作流。
  5. 验证和构建。
  6. Git 提交。

这就是从“会问 AI”到“会用 AI 做项目”的区别。

小结 ​

综合实战的重点不是 TODO 工具。 重点是完整流程。

你只要能跑通一次：写规则、派任务、看 diff、跑检查、提交，就已经跨过最重要的门槛了。