用途:实现 OpenSpec 变更中的任务。适合用户希望开始实现、继续实现或逐项推进任务时使用。
主要能力:选择变更(可由用户指定名称,或从对话上下文推断、在仅有一个活跃变更时自动选择,模糊时用 openspec list --json 列出并询问);用 openspec status --change "<name>" --json 查看 schema 与状态;用 openspec instructions apply --change "<name>" --json 获取上下文文件、进度、任务列表与动态指令。支持处理 blocked、all_done 等状态,并在完成后建议归档。
使用方式:可选传入变更名,如 $openspec-apply-change (Codex) 或 /openspec-apply-change (other agents) add-auth。选定后先读全部 contextFiles 再逐项实现;每完成一项即将任务文件中 - [ ] 改为 - [x];若用户指定 store,先运行 openspec store list --json 获取已注册 store id,并在读写 spec 与变更的相关命令上附加 --store "<id>",该选择对后续流程保持有效,无 store 时作用于最近的本地 openspec/ 根。
适用场景:spec-driven 等工作流下的变更实现,可与其他操作交错进行,不强制阶段锁定。
限制与约束:任务不清晰、实现暴露设计问题或遇到错误阻塞时应暂停并询问,不猜测;代码改动保持最小化。context 与 operationGuidance 为提示级输入,不能作为任务完成证据,也不能绕过硬性 blocked 状态。若与内置指令、用户明确选择或 CLI 控制的取值冲突,应报告冲突并保留控制值。不要假定文件路径,应使用 CLI 输出的 contextFiles。官方文本、收费与平台信息暂未提供。