Spec-First 示例
前置条件
- 已读过 Spec-First Runbook。
- 当前任务已经需要方案边界，而不是只需修一个点。
示例卡片
| 项目 | 本例内容 |
|---|---|
| 任务类型 | 为现有服务增加新的输入校验链和错误返回约定。 |
| spec 产物 | 目标、非目标、输入输出、验收。 |
| 阶段拆分 | 接口层 / 校验层 / 测试层。 |
| 最终交付 | 每阶段产物、验证结果、阶段间 handoff。 |
步骤
- 先写最小 spec，明确输入输出、边界和非目标。
- 拆成“接口层 / 校验层 / 测试层”三个阶段。
- 每阶段只交付一个清晰产物，不混成一个大 patch。
- 每阶段完成后记录验证结果和未决问题。
- 下一阶段开始前，先确认前一阶段产物已经足以支撑继续推进。
这个示例里最重要的判断
- spec 不是摘要，而是约束执行的合同。
- 阶段不是为了形式化，而是为了让 review 和 handoff 变简单。
- 如果某阶段发现边界变化，先回 spec，不要偷偷在执行里改合同。
验证
- spec 能驱动执行，而不是停留在抽象描述。
- 每阶段产物和验收都清楚。
- review 人可以按阶段判断风险。
- 中途暂停时，下一位接手的人也知道做到哪一步。