用途
specify-plan 是一个实现规划技能,用于创建并校验实现计划(PLAN)。它扮演实现规划专家的角色,按照 TDD 原则将功能拆解为可执行任务,使开发者能够独立工作而无需额外澄清。
适用场景包括:规划实现阶段、定义任务、排序工作、分析依赖,以及其他与实现计划相关的规划工作。
主要能力
该技能为任务定义了统一结构:
- id:如 T1.1、T1.2、T2.1
- description:任务描述
- ref:指向 SDD/章节 + 行范围
- activity:如 domain-modeling、backend-api、frontend-ui
- parallel:是否可并行
- prime:开工前需要阅读的内容
- test:需要测试的内容(红)
- implement:需要构建的内容(绿)
- validate:如何验证(重构)
其维护的状态包括 specDirectory、prd、sdd、planDirectory、phases。
计划需回答四个问题:
- WHAT 产生价值?——交付物,而非活动
- IN WHAT ORDER 任务如何执行?——依赖与排序
- HOW TO VALIDATE 正确性?——测试先行
- WHERE 每个任务的规格在哪?——链接到 PRD/SDD 章节
技能附带参考材料,包括计划清单模板(plan/README.md)、阶段模板、校验清单、任务结构说明、输出格式、输出示例与阶段示例。
使用方式
工作流分五步:
- 初始化计划:从 specDirectory 读取 PRD 与 SDD,读取模板,将模板写入 specDirectory/plan/README.md,并从 SDD 组件识别实现领域。
- 发现任务:启动并行专家代理,调查任务排序与依赖、各组件测试策略、风险评估与缓解、并行执行机会。
- 定义阶段:读取阶段模板,按任务结构模式定义任务,为每个任务添加规格引用,将阶段写入 specDirectory/plan/phase-N.md,更新 plan/README.md 的阶段清单,并展示带依赖与并行机会的任务拆解。
- 校验计划:按校验清单执行,重点检查规格合规(每个 PRD 验收标准映射到任务、每个 SDD 组件有实现任务、所有任务引用指向有效规格章节)、多文件结构(README.md 存在且列出所有阶段文件、阶段文件 frontmatter 状态正确)、偏差处理协议(记录偏差及理由、获得批准后再继续、偏差改进设计时更新 SDD)、完整性(最终阶段定义集成与 E2E 测试、项目命令匹配实际项目设置、开发者可独立按计划执行)。
- 呈现状态:按输出格式参考文件格式化状态报告,并询问下一步:定义下一阶段 | 运行校验 | 处理缺口 | 完成 PLAN。
约束
始终要求:
- 每个任务产出可验证交付物,而不仅是活动
- 所有 PRD 验收标准映射到具体任务
- 所有 SDD 组件有对应实现任务
- 依赖显式且无循环依赖
- 每个任务遵循 TDD:Prime、Test、Implement、Validate
- 严格遵循模板结构,保留所有已定义章节
- 进入下一阶段前等待用户确认
- 每个阶段写入独立的 plan/phase-N.md 文件
- plan/README.md 作为清单,含阶段链接与勾选清单
- 所有任务可追溯到规格需求
- 并行任务确实能独立运行
- plan/README.md 的阶段清单保持精确格式 - [ ] Phase N: Title,该格式由 implement 技能解析用于阶段发现与状态跟踪
从不要求:
- 包含时间估算——关注做什么,而非何时
- 包含资源分配——关注工作,而非由谁做
- 包含实现代码——计划负责引导,实现另行跟进
- 把准备步骤(读取规格、运行 lint)当作独立任务
- 把单个测试用例当作任务——它们是更大交付物的一部分
- 任务中缺失规格引用
- 把所有阶段写入单一巨型文件
限制
资料未提供收费、价格、平台支持、性能效果等具体信息。