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 中列出的文件;展示进度并逐条实现任务,完成后把 - [ ] 改为 - [x]。

使用方式:若用户指定 store 或工作位于某个 store,先运行 openspec store list --json 获取已注册 store id,再在读取或写入 specs 与 changes 的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上追加 --store <id>,并在后续流程中保持该标志;其他命令不接受该标志。未指定 store 时,命令作用于最近的本地 openspec/ 根目录。状态为 blocked 时提示使用 continue-change 或查看下一工件;状态为 all_done 时建议归档。

适用场景:按 spec-driven 等 schema 推进变更实现,支持在工件未全部完成、部分实现后或与其他动作交错时调用。

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