SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:从 OpenSpec 变更中实现任务,适用于开始实现、继续实现或逐项推进任务清单。

主要能力:选择变更(可指定名称,或从上下文推断、唯一活跃变更自动选中,歧义时用 openspec list --json 让用户选择);用 openspec status --change "<name>" --json 查看 schema、planningHome、changeRoot、actionContext 及任务所在产物;用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令。

使用方式:若指定 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>,选定后保持粘性。读取 contextFiles 中列出的文件后展示进度,逐项实现:显示当前任务、做最小且聚焦的代码改动、把任务文件中 - [ ] 改为 - [x],继续下一项。

状态处理:state 为 blocked 时提示用 openspec-continue-change(未安装则用 status 与 instructions 查看下一产物);all_done 时祝贺并建议归档;否则进入实现。

限制:任务不清晰、发现设计问题、遇到错误或阻塞、用户中断时暂停并等待指示,不猜测;context 与 operationGuidance 属提示级输入,不能作为任务完成证据,也不能绕过 blocked 状态;与内置指令、用户明确选择或 CLI 控制值冲突时报告冲突并保留控制值;不把运行时上下文或操作指引原样复制进实现文件或规划产物。