| name | implement |
| description | 编码实现方法论:垂直切片 + TDD 核心循环。在 dev-flow 流程的第 5 步自动加载。 |
| version | 1.0.0 |
编码实现 · 方法论
你的任务
按照技术方案(计划.md)实施编码。核心思路:垂直切片——每个切片走通全链路,而非按层水平推进。
核心方法:垂直切片(Tracer Bullet)
将计划.md 中的子任务拆分为垂直切片:
❌ 水平切片(错误方式):
先做数据层:表 A、表 B、表 C
再做接口层:API 1、API 2、API 3
最后做展示层:页面 X、页面 Y、页面 Z
✅ 垂直切片(正确方式):
切片 1:表 A → API 1 → 页面 X(走通一条完整路径)
切片 2:表 B → API 2 → 页面 Y(又一条完整路径)
切片 3:表 C → API 3 → 页面 Z(最后一条路径)
每个切片完成后可以独立演示或验证,不依赖其他切片。
编码循环:RED → GREEN → REFACTOR
有测试框架的项目,每个切片内跑 TDD 循环:
RED → 写一个描述行为的测试,运行,确认失败
GREEN → 写最小实现让测试通过,不多写
REFACTOR → 测试通过后重构,消除重复,保持测试绿色
规则:
- 一次只处理一个切片
- 一个切片内,一次只写一个测试
- 只写让当前测试通过的最小代码
- 不要预测后续切片需要什么
- RED 状态下绝不重构——先 GREEN,再重构
测试运行节奏
- 每次提交前:跑类型检查(
npm run typecheck 或等效命令)
- 每个切片完成后:跑该切片相关的测试文件
- 所有切片完成后:跑完整测试套件
- 如果发现测试失败:立即修复,不要积累
执行流程
- 读取计划.md,理解所有子任务和验收标准
- 拆分为垂直切片:每个切片走通一条完整的 数据→接口→展示→测试 路径
- 按依赖顺序执行切片(无依赖的切片先做)
- 每个切片内:
- 写测试(RED)
- 写实现(GREEN)
- 重构(REFACTOR)
- 跑测试确认绿色
- 所有切片完成后:跑完整测试套件
- 更新计划.md:每个完成的子任务标记状态
- 归集非代码交付物:编码过程若产生 SQL 脚本、接口文档、上线注意事项等,按需写入会话目录(建议归到
<session_dir>/交付物/ 下),供第 8 步总结引用;没有则不硬造
无测试框架的项目
如果项目没有测试框架,跳过 TDD 循环,但仍然保持垂直切片思路:
- 每个切片完成后手动验证核心路径
- 用日志/打印确认数据流转正确
- 切片粒度可以稍大(以可手动验证为单位)
注意事项
- 遵循项目的代码风格和规范(参考 dev-flow 配置文件中的个人偏好)
- 不要在一次编码中做所有事,按切片逐步推进
- 每完成一个切片,用 TodoWrite 更新进度
- 完成后进入步骤 6(自测)