SuperAPI AI 工具集

openspec-dev

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

用途:把 OpenSpec 变更提案转换为可执行计划,并逐阶段委派实现。它是薄适配层,自身不重复实现与审查逻辑,而是委托给 superpowers:subagent-driven-development 等技能。

前置条件:存在已批准的 proposal.md 的 OpenSpec 变更;tasks.md 已按阶段组织好任务;main 分支 git 状态干净。

调用方式:/openspec-dev <change-id> [phases]。change-id 为必填,指定变更目录名;phases 为可选,用数字范围过滤,如 2、1,3,5、2-4、1,3-5,7,忽略空白、去重并升序排列。阶段编号按 tasks.md 中 ## Phase 出现顺序计。非法阶段号会警告并跳过,已完成阶段会记录并跳过,格式错误则报错并给出用法示例。

主要流程:读取 openspec/changes/<change-id>/ 下的 proposal.md 与 tasks.md,提取未勾选任务并按阶段分组;对每个含未勾选任务的阶段,先切出 feat/<change-id>-phase-N 分支,把阶段任务转成计划,按 subagent-driven-development 流程逐个任务派发实现子代理,采用 TDD,并做规格符合性与代码质量两阶段审查,然后为该阶段创建 PR。每个任务通过双审后,将源 tasks.md 中对应项由 - [ ] 改为 - [x] 并提交到阶段分支;阶段 PR 创建后再为已完成任务补上 PR 编号。全部阶段完成后输出汇总表,列出各阶段分支、PR 与状态(Ready、Skipped (not in filter)、Skipped (already complete))。

这样设计的原因:支持中断后恢复(进度写入 tasks.md)、便于任何人查看当前状态、具备幂等性(重跑会跳过已勾选任务)。

限制:需依赖 OpenSpec 目录结构与已批准提案、tasks.md 阶段划分、干净 git 状态及相关配套技能,缺一不可;未提供收费、价格、平台等信息。