用途:从 OpenSpec 变更中实现任务,适合开始实现、继续实现或逐项推进任务的场景。
主要能力:选择变更、检查状态与 schema、获取 apply 指令、读取上下文文件、显示进度、逐项实现任务并在 tasks 文件中把 - [ ] 改为 - [x],完成后建议归档。
用法:可选传入变更名,如 $openspec-apply-change(Codex)或 /openspec-apply-change(其他 agent)add-auth;未提供时根据上下文推断,仅有一个活跃变更则自动选择,含糊时运行 openspec list --json 让用户选择。核心命令:openspec status --change "<name>" --json、openspec instructions apply --change "<name>" --json。若使用已注册 store,先运行 openspec store list --json,然后在读写 specs 与 changes 的命令上追加 --store <id>,并在后续命令中保持。无 store 时作用于最近的本地 openspec/ 根目录。
状态处理:blocked 时提示使用 continue-change;all_done 时祝贺并建议归档;否则进入实现。需读取 contextFiles 列出的所有文件,视 context 为必需输入,operationGuidance 为可选建议,二者不能替代内置指令或绕过 blocked。
限制:任务不明确、暴露设计问题、遇到错误或阻塞时应暂停并询问,不猜测;改动保持最小、按任务限定范围;不得把上下文或操作指引原文复制进实现文件或规划产物;具体 schema 支持、价格与平台信息资料未提供。