第 7 章
实战
20 分钟7 / 8

实战:用 Codex 完成一个小功能

从需求到测试绿:带你走完「待办应用加标签筛选」的完整代理协作流程。

实战
功能
测试

假设你有一个本地待办应用(任意栈)。目标:为待办增加「标签」字段,并支持按标签筛选。以下对话可直接改编使用。

准备

  • 干净 git 状态:git status 无无关脏文件
  • 能本地启动与跑测试
  • 开新分支:git checkout -b feat/todo-tags

主提示词

text·复制即用
【目标】
为待办项增加可选 tags: string[],UI 可按标签筛选。

【范围】
数据层、列表 UI、筛选控件、相关测试。
不要改鉴权与部署配置。

【约束】
- 旧数据无 tags 时视为 []
- 筛选为「包含任一所选标签」
- 移动端筛选控件可用(触控友好)
- 视觉风格与现有组件一致

【流程】
1. 只读探索并总结现状
2. 给出实现计划与文件列表
3. 等我批准
4. 实现 + 测试
5. 汇报如何手动验证

【验收】
- 类型检查通过
- 相关测试通过
- 我能:创建带标签的 todo → 筛选只显示匹配项

你要重点审的点

  1. 1

    数据兼容

    旧记录缺字段是否崩溃?序列化是否正确?

  2. 2

    筛选语义

    空筛选 = 全部?大小写是否敏感?是否符合产品预期?

  3. 3

    测试真实性

    测试是否只断言实现细节?是否覆盖边界(无标签、多标签)?

  4. 4

    UI 回归

    窄屏是否溢出?键盘与点击是否都能操作筛选?

收口

bash·提交前
git diff
# 跑项目既有检查,例如:
npm run typecheck
npm test

git add -A
git commit -m "feat(todos): add tags and filter by tag"