第 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
数据兼容
旧记录缺字段是否崩溃?序列化是否正确?
- 2
筛选语义
空筛选 = 全部?大小写是否敏感?是否符合产品预期?
- 3
测试真实性
测试是否只断言实现细节?是否覆盖边界(无标签、多标签)?
- 4
UI 回归
窄屏是否溢出?键盘与点击是否都能操作筛选?
收口
bash·提交前
git diff
# 跑项目既有检查,例如:
npm run typecheck
npm test
git add -A
git commit -m "feat(todos): add tags and filter by tag"