SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:从 OpenSpec 变更中实现任务,适合用户要开始、继续或逐项推进某个变更的实现工作时使用。

主要能力:选择变更(可指定名称,或从上下文推断、唯一活跃变更自动选中、歧义时列出让用户选择);用 openspec status --change "<name>" --json 查看 schema、planningHome、changeRoot、actionContext 等;用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令;读取 contextFiles 中列出的文件(spec-driven 通常为 proposal、specs、design、tasks);逐项实现任务并把 tasks 文件中的 - [ ] 改为 - [x];完成后建议归档。

使用方式:若使用已注册的 store,先运行 openspec store list --json 获取 id,再在读写 specs 与 changes 的命令上加 --store <id>(如 openspec status --change "<name>" --json --store "<id>"),该标志在后续流程中保持;无 store 时作用于最近的本地 openspec/ 根目录。状态为 blocked 时提示用 openspec-continue-change 或查看下一 artifact;all_done 时建议归档。

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