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、进度、任务列表与动态指令。

使用方式:读取 contextFiles 中列出的全部文件(spec-driven 通常为 proposal、specs、design、tasks),展示进度后逐项实现,保持改动最小且聚焦,完成后立即把任务文件中的 - [ ] 改为 - [x],循环直到完成或被阻塞。若指定了 store,先运行 openspec store list --json 获取 id,并在读写 specs 与 changes 的命令上追加 --store <id>,该标志在后续流程中保持。

状态处理:state 为 blocked 时提示使用 openspec-continue-change;all_done 时建议归档;否则进入实现。context 视为必需的提示级输入,operationGuidance 为可选补充建议,二者不得作为任务完成的证据,也不得绕过 blocked 状态;与内置指令、用户明确选择或 CLI 控制值冲突时应报告冲突并保留控制值。

限制:任务不清晰、发现设计问题、遇到错误或阻塞、用户中断时暂停并等待指引,不要猜测;不要假设文件名,以 CLI 输出的 contextFiles 为准;不要把上下文或操作指引原文复制进实现文件或规划产物。该技能可随时调用,支持与其他动作交错进行。