用途:从 OpenSpec 变更中实施任务,适用于用户要开始实施、继续实施或逐项推进任务时。
主要能力:选择变更后可查看工作流 schema 与状态,获取 apply 指令,读取上下文文件,显示进度并循环实施任务,完成一项即在任务文件中把“- [ ]”标记为“- [x]”。支持指定 store(已注册的独立 OpenSpec 仓库),用 openspec store list --json 发现 store id,并在规格与变更相关命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上附加 --store <id>,选定后在该工作流中保持粘性;其他命令不接受该标志。无 store 时作用于最近的本地 openspec/ 根目录。
使用方式:可选指定变更名(如 $openspec-apply-change (Codex) 或 /openspec-apply-change (other agents) add-auth);无论是否指定,都会先声明“Using change: ”及覆盖方式。随后运行 openspec status --change "<name>" --json 了解 schemaName、planningHome、changeRoot、actionContext 及含任务的产物;再运行 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令。状态为 blocked 时提示改用 $openspec-continue-change 或 /openspec-continue-change;为 all_done 时提示可归档;否则进入实施。实施前必须读取 contextFiles 中的全部文件。context 为必需的提示级输入,operationGuidance 为可选补充建议,二者与 CLI 返回状态、任务、进度、contextFiles 及内置指令分开对待,不得作为任务完成的证据或绕过 blocked 状态;若冲突需报告并保留控制值。
适用场景:按 OpenSpec 变更推进规格驱动或其他 schema 的任务实施。
限制:任务不明确、实现暴露设计问题、遇到错误或阻塞时应暂停并等待指引;不猜测,保持改动最小且聚焦;不得把运行时上下文或操作指引复制进实现文件或规划产物;缺失事实资料暂未提供。