SuperAPI AI 工具集

spec-plan

编程与开发

查看项目

更新于 10-16 06:45

技能介绍

用途:在已有已批准的 spec.md 之后,将规格拆解为可直接执行的实施计划,并生成结构化任务。该技能不写代码,实施由 spec-implement 负责。

主要能力:读取已批准的 spec.md,先写一份详细计划草稿(Markdown,可置于 spec.md 末尾或独立文件),供人工批注;支持注释迭代循环(写计划→人工加注→逐条处理→重复1-6次);人工批准后将计划转为 plan.json,并按已加载的任务跟踪技能创建任务。产物目录为 docs/specs/YYYY-MM-DD-<feature-name>/,包含 spec.md 与 plan.json。

plan.json 结构:包含 feature、spec、goal、phases;phases 含 id、name、tasks;task 含 id、name、depends_on、files.create、files.modify、steps;step 的 action 取 write_test、verify_fail、implement、verify_pass、commit,并带 description、code、file、command、expected、message 等字段。

使用方式:Step 1 读规格写草稿并停止等待评审;Step 2 处理人工批注,只更新计划、不创建任务、不实现;Step 3 人工明确批准后转为 plan.json,加载任务跟踪技能建任务(无则用 TodoWrite 兜底),建 epic、按阶段建任务、按依赖(如 Entity 先于 Repository)连接。之后交接到 spec-implement。

计划质量与粒度:面向不了解本代码库的开发者,需给出精确文件路径、完整代码与确切命令;每个步骤为单一动作(写失败测试、验证失败、写最小实现、验证通过、提交),每个任务控制在2-5分钟内,过长需继续拆分;任务按 Entity→Repository→Service→Router/Consumer 自底向上依赖排序。

验证与限制:生成后需检查每任务有 ID 与 depends_on、依赖无环、每任务至少一步、路径完整、代码片段完整。严格遵循“尚未实现”的守则,计划未经人工明确批准不得创建任务或实现;若实现中发现缺任务则更新 plan.json,设计有误则回到 research。适用场景为规格已定、需拆解为可执行任务的前期规划。收费、价格与平台支持等未提供。