SuperAPI AI 工具集

implement-openspec-changes

编程与开发

查看项目

更新于 10-18 02:31

技能介绍

Implement OpenSpec Changes 技能用于端到端地实施并提交一个或多个 OpenSpec 变更。调用方式为 /implement-openspec-changes [change-id ...]。

用途:当用户调用该命令或要求完整实施并提交 OpenSpec 变更时使用。每个变更依次执行 apply → verify → fix → goodreview → fix → commit,多个变更按顺序逐个处理。

使用方式与准备:不提供 ID 时,通过 openspec list --json 或检查 openspec/changes/(排除 archive/)列出活动变更并询问要实施哪些;开始前校验所有提供的 ID,缺失变更即停止。需在运行时已安装技能、项目/用户技能目录或本仓库 skills/ 中定位 openspec-apply-change、openspec-verify-change、goodreview 和 git,缺失依赖时停止并指明。每个变更开始前记录 HEAD、已暂存/未暂存差异和未跟踪文件,并以此基线跟踪本变更的文件与 hunk,保留无关工作及其暂存状态;归属重叠不明确时先询问再修改或提交。

执行流程:由宿主编排,在启动每一步的通用子代理前宣布 <change-id> · N/6 · <step>,等待完成后再推进;不使用隔离工作树或命名自定义代理。子代理不可用时本地执行相同门禁并标注回退。每个子代理需获得仓库路径、变更 ID、范围/基线、执行/修复门禁、相关依赖技能路径及前序报告,并被要求阅读技能和引用资源;仅 apply/fix 子代理可编辑,仅 commit 子代理可暂存或提交。各步骤需返回状态、发现/处置、更改文件、检查/结果和阻塞项;报告缺失或失败视为阻塞。

六个步骤:1. Apply 遵循 openspec-apply-change,返回任务进度,暂停、阻塞或必需任务未完成则停止,已完成任务进入验证。2. Verify 遵循 openspec-verify-change 并运行相关项目检查,返回完整评分卡及所有 Critical、Warning、Suggestion。3. Fix verification 无发现则跳过,否则按修复规则处理并重跑验证。4. Review 遵循 goodreview(含专家简报),范围为本变更未提交工作,返回完整报告与提交就绪状态。5. Fix review 无发现则跳过,否则按修复规则处理,编辑后运行相关测试/检查,行为或任务覆盖变化时重跑 OpenSpec 验证,必要时重新审查受影响区域。6. Commit 遵循 git 的 /git commit 工作流,仅限本变更;检查确切提交差异,排除无关内容(包括预暂存编辑和混合文件 hunk)并保留其暂存状态;创建原子常规提交,不带 AI 署名;返回哈希或无内容可提交;除非要求,不提示推送/PR。

修复与完成门禁:处理本变更内每个严重级别;仅在有证据证明误报时驳回,不扩大范围或削弱需求/测试来消除发现。每个修复步骤最多两轮修复与验证,返回每个发现的处置与验证证据。存在真实发现、必需检查失败或无法运行、或解决需用户决策时停止。仅当所有必需任务完成、所有发现已解决或证明为误报、且最终代码通过相关检查时才提交;仅阅读文件不能验证行为修复。遇到阻塞即停止流水线,剩余变更排队,保留已完成工作并报告阻塞与下一步;除非要求,不创建 issue、归档变更、推送或开 PR。最终以 change-id | apply | verify | review | commit | result 格式结束,包含提交哈希、检查结果、合理驳回及停止/排队变更。

适用场景:需要按严格门禁端到端实施 OpenSpec 变更并生成原子提交的开发工作流。

限制:依赖 OpenSpec 提供的 apply/verify 技能及 GoodSkills 提供的 goodreview 与 git 技能;子代理不可用时仅能本地回退;每步修复最多两轮;不可用功能与收费信息暂未提供。