用途:从 OpenSpec 变更中实现任务,适用于开始实现、继续实现或逐项完成任务的场景。
主要能力与用法:支持指定变更名(如 $openspec-apply-change (Codex) 或 /openspec-apply-change (其他代理) add-auth);未指定时根据对话上下文推断,仅一个活跃变更时自动选择,含糊则运行 openspec list --json 让用户选择。开始前会宣布“Using change: ”及覆盖方式。随后用 openspec status --change "<name>" --json 了解 schemaName、planningHome、changeRoot、actionContext 及承载任务的 artifact,再用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令。状态 blocked 时提示使用 $openspec-continue-change(未安装则用 status 与 instructions 查看下一步);all_done 时建议归档;否则进入实现。实现前读取 contextFiles 中全部文件路径,展示进度,然后逐个任务做最小改动,并在 tasks 文件把 - [ ] 改为 - [x],直到完成或受阻。
Store 选择:用户指定 store 或工作位于某 store 时,先运行 openspec store list --json 获取 id,再在读写规格与变更的命令上追加 --store <id>,并在后续保持该作用。命令提示中已带该标志时需保留;不支持的其它命令不加。无 store 时作用于最近的本地 openspec/ 根。
适用场景:配合 OpenSpec 的 spec-driven 等 schema,按 tasks 或其它 artifact 中列出的任务推进实现。
限制与约定:context 为必需提示级输入,operationGuidance 为可选建议,二者不得作为任务完成的证据,不得替代内置指令或绕过 blocked 状态;与内置指令、用户明确选择或 CLI 控制值冲突时应报告并保留控制值。不得把上下文或操作指引原文复制进实现文件或规划产物(除非用户另行要求)。任务不清晰、出现设计问题、错误或阻塞时暂停并等待指示。此技能支持“actions on a change”模型,可在任意时间调用,允许建议更新 artifact。