SuperAPI AI 工具集

openspec-apply-change

通用与其它

查看项目

更新于 10-16 01:13

技能介绍

用途:按 OpenSpec 变更(change)中的任务清单实施代码改动,适用于开始实现、继续实现或逐项推进任务的场景。

主要能力:可选择变更(可指定名称,或从对话上下文推断;若只有一个活跃变更可自动选中,若含义不清则用 openspec list --json 列出并让用户选择);用 openspec status --change "<name>" --json 查看 schema、规划范围与编辑约束及任务所在工件;用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令。之后读取 contextFiles 中列出的文件,展示进度并逐项实现,完成后把任务文件里的 - [ ] 标记为 - [x]。

使用方式:支持指定 store。若用户指名某个 store 或工作在某个已注册的独立 OpenSpec 仓库中,先运行 openspec store list --json 获取 id,再在读取或写入 specs 与 changes 的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上附加 --store <id>,选定后保持粘性;其他命令不带该参数。未指定 store 时作用于最近的本地 openspec/ 根目录。Codex 用 $openspec-apply-change,其他 agent 用 /openspec-apply-change,可附加变更名。

状态处理:state 为 blocked 时提示缺失工件并建议走继续创建流程;state 为 all_done 时祝贺并建议归档;否则进入实现。完成或暂停时输出本次完成任务与总体进度;全部完成可提示用归档命令收尾。

限制:任务含义不清、实现暴露设计问题、遇到错误或阻塞、用户中断时应暂停等待指示,不应猜测;需在实现前读取全部 contextFiles;代码改动保持最小且聚焦;每条任务完成即刻更新勾选;context 与 operationGuidance 属提示级输入,不能作为任务完成的证据,也不得覆盖 CLI 控制的状态、阻塞判断与完成标准;若与内置指令或用户明确选择冲突需报告并保留控制值。其他细节以实际 CLI 输出为准。