spec-and-plan
Installation
SKILL.md
spec 与 plan
两份文档,两个时机。spec 回答做什么、做到什么算完,它是承诺,要人认可,所以在交接期的定约时由设计会话和人一起写。plan 回答按什么顺序做、每片怎么验,它在交付期开头由交付的主代理写,计划者就是执行者。一程的承诺、大小与交出收回归交接期,由设计会话做,人在场。做法加载技能 pass-the-baton。
顺序
先 spec 后 plan,不并行。plan 是 spec 的分解,spec 没定边界就切片,切出来的片会互相打架。两者之间隔着定程与交出:一程多大、要不要分程,在 spec 定好之后、plan 动笔之前定。
写 spec(定约时)
按 Matt 的 to-spec 做:综合会话里已经讨论和定义期已经落盘的内容,不重新访谈;先找测试接缝,越高越好、越少越好。填 spec 模板。本模板比 Matt 的骨架多五节,每节对应定义期的一个产出:
| 节 | 来自定义期的 | 为什么要有 |
|---|---|---|
| 依据与已定事项 | 正式落盘的文档与修订 | 让每条实施决定能追到已接受的承诺 |
| 不变式对照 | 需求与不变式单 | 每条不变式写由什么守、怎么验,不留口头承诺 |
| 跨域概念的五问 | 领域影响分级表 | 新增或改变跨域概念时必填,没有时写不适用 |
| 失败语义 | 细化设计清单 | 正常、失败、未知、取消与清理、外部效果五行,各写行为、责任人、验证 |
| 责任分级 | 领域影响分级表 | 让交付期有可核对的边界 |