SuperAPI AI 工具集

specify-plan

编程与开发

查看项目

更新于 10-16 02:10

技能介绍

用途

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)、阶段模板、校验清单、任务结构说明、输出格式、输出示例与阶段示例。

使用方式

工作流分五步:

  1. 初始化计划:从 specDirectory 读取 PRD 与 SDD,读取模板,将模板写入 specDirectory/plan/README.md,并从 SDD 组件识别实现领域。
  2. 发现任务:启动并行专家代理,调查任务排序与依赖、各组件测试策略、风险评估与缓解、并行执行机会。
  3. 定义阶段:读取阶段模板,按任务结构模式定义任务,为每个任务添加规格引用,将阶段写入 specDirectory/plan/phase-N.md,更新 plan/README.md 的阶段清单,并展示带依赖与并行机会的任务拆解。
  4. 校验计划:按校验清单执行,重点检查规格合规(每个 PRD 验收标准映射到任务、每个 SDD 组件有实现任务、所有任务引用指向有效规格章节)、多文件结构(README.md 存在且列出所有阶段文件、阶段文件 frontmatter 状态正确)、偏差处理协议(记录偏差及理由、获得批准后再继续、偏差改进设计时更新 SDD)、完整性(最终阶段定义集成与 E2E 测试、项目命令匹配实际项目设置、开发者可独立按计划执行)。
  5. 呈现状态:按输出格式参考文件格式化状态报告,并询问下一步:定义下一阶段 | 运行校验 | 处理缺口 | 完成 PLAN。

约束

始终要求:

  • 每个任务产出可验证交付物,而不仅是活动
  • 所有 PRD 验收标准映射到具体任务
  • 所有 SDD 组件有对应实现任务
  • 依赖显式且无循环依赖
  • 每个任务遵循 TDD:Prime、Test、Implement、Validate
  • 严格遵循模板结构,保留所有已定义章节
  • 进入下一阶段前等待用户确认
  • 每个阶段写入独立的 plan/phase-N.md 文件
  • plan/README.md 作为清单,含阶段链接与勾选清单
  • 所有任务可追溯到规格需求
  • 并行任务确实能独立运行
  • plan/README.md 的阶段清单保持精确格式 - [ ] Phase N: Title,该格式由 implement 技能解析用于阶段发现与状态跟踪

从不要求:

  • 包含时间估算——关注做什么,而非何时
  • 包含资源分配——关注工作,而非由谁做
  • 包含实现代码——计划负责引导,实现另行跟进
  • 把准备步骤(读取规格、运行 lint)当作独立任务
  • 把单个测试用例当作任务——它们是更大交付物的一部分
  • 任务中缺失规格引用
  • 把所有阶段写入单一巨型文件

限制

资料未提供收费、价格、平台支持、性能效果等具体信息。