SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:从 OpenSpec change 中实现任务,适用于用户想开始实现、继续实现或逐项推进任务时。

主要能力:选择 change(可由参数指定、从对话推断或自动选择唯一活动 change);通过 openspec status --change "<name>" --json 了解 schema、planningHome、changeRoot、actionContext 及任务所在 artifact;通过 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令;读取 contextFiles 中列出的文件后逐项实现,并在任务文件中把 - [ ] 改为 - [x]。

使用方式:可选指定 change 名,如 $openspec-apply-change (Codex) 或 /openspec-apply-change (other agents) add-auth。若指定了 store,先运行 openspec store list --json 获取 id,再在读写 specs 与 changes 的命令上追加 --store <id>,且该选择在后续流程中保持。未指定 store 时作用于最近的本地 openspec/ 根目录。

状态处理:state 为 blocked 时提示使用 $openspec-continue-change (Codex) 或 /openspec-continue-change (other agents);all_done 时建议归档;否则进入实现。context 视为必需的提示级输入,operationGuidance 为可选补充建议,二者不得作为任务完成证据,也不得绕过 blocked 状态。

限制:任务不清晰、发现设计问题、遇到错误或阻塞、用户中断时应暂停并等待指示;改动应最小且聚焦;不要假设文件名,应使用 CLI 输出的 contextFiles;不得把运行时上下文或操作指引复制进实现文件或规划产物。资料未提供具体安装命令、收费与平台信息。