SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:当用户希望开始、继续或逐项完成某个 OpenSpec 变更中的任务时使用。它围绕“对变更执行操作”的模型,可在所有工件完成前(若任务已存在)、部分实现之后,或与其他操作交错时调用。

主要能力:选择变更(支持名称、上下文推断、唯一活跃变更自动选择,歧义时列出并询问);用 openspec status --change "<name>" --json 了解 schema、planningHome、changeRoot、actionContext 及任务所在工件;用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表、动态指令及可选的上下文与 operationGuidance;按 schema 读取 proposal/specs/design/tasks 等文件;逐个实现任务并在任务文件中把 - [ ] 改为 - [x];显示进度,完成后建议归档,遇到问题时暂停并给出选项。

用法要点:可指定变更名(Codex 用 $openspec-apply-change,其他代理用 /openspec-apply-change 加名称),缺省时推断。若用户指定 store 或工作位于某个 store,先执行 openspec store list --json 获取 id,并在读取或写入规格与变更的命令上追加 --store <id>,该选择在工作流后续保持粘性;无 store 时作用于最近的本地 openspec/ 根目录。状态为 blocked 时提示使用 continue-change,all_done 时建议归档。

限制:需先读上下文文件再开始;任务不明确、暴露设计问题或出现错误/阻塞时应暂停询问,不做猜测;代码改动保持最小且限定范围;不得把上下文或操作指引当作任务完成的证据,也不得据此绕过 blocked 状态;与内置指令、用户明确选择或 CLI 控制值冲突时应报告并保留控制值。