一句话

写代码前先写 spec：SPECIFY、PLAN、TASKS、IMPLEMENT 四道人工门禁，跨能力的大需求先画 capability map。

何时用

• 适合：新项目、新功能或大改动还没有规格；要写 PRD 或需求文档；需求模糊只是个想法；一个需求含多个可独立测试的能力。
• 不适合：一两句说清的小改动；已有合格 spec 只差实现。

怎么用

给团队空间的邀请功能写一份 spec，验收标准也要

1. Phase 0 范围检查：一个需求捆了多个可独立测试能力时，先画 capability map（模块表加构建顺序）。
2. Phase 1 Specify：写 SPEC.md，含目标、技术栈、命令、结构、风格、测试策略、边界、成功标准、开放问题。
3. 写完 spec 立即停回合：摘要加开放问题交给用户，批准后才进 Phase 2。
4. 后续各阶段同样过人工门禁，plan、tasks、implement 逐步放行。
5. spec 是活文档，实现中发现的出入回写 SPEC.md。

产出

• SPEC.md（或经 capability map 拆出的多份 spec），给 addy-planning-and-task-breakdown 当输入。

要点与坑

• 门禁是重点：没经批准不跨阶段，spec 落盘后这轮就停。
• Phase 0 是例外不是常态，单能力需求直接进 Specify。
• 对应命令：/spec 触发本技能，/plan、/build 接后续阶段。

本机版本差异

仓库版硬性要求写完 spec 立即结束回合、等用户批准后才进 Phase 2；本机旧版允许同一回合继续往下走。

关联

• 上游：addy-interview-me、addy-idea-refine · 下游：addy-planning-and-task-breakdown · 同类：matt-to-spec
• 所属：00-addy-概览 · 工作流：W3-多会话功能