用途:从 OpenSpec 变更中实现任务。当用户想开始实现、继续实现或逐项完成某变更的任务时使用。
主要能力:选择变更(可显式指定名称,或从对话上下文推断、仅一个活跃变更时自动选择,歧义时用 openspec list --json 让用户选择);用 openspec status --change "<name>" --json 查看 schema、planningHome、changeRoot、actionContext 及任务所在工件;用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令;读取 contextFiles 中列出的全部文件;逐项实现任务并把 tasks 文件中的 - [ ] 改为 - [x];完成后建议归档。
Store 选择:若用户指定 store 或工作位于某个 store,先运行 openspec store list --json 获取已注册 store id,再在读写 specs 与 changes 的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上追加 --store <id>,选定后保持粘性;其他命令不接受该标志。未指定 store 时作用于最近的本地 openspec/ 根目录。
状态处理:state 为 blocked(缺少工件)时提示使用 continue-change 或查看下一工件;state 为 all_done 时祝贺并建议归档;否则进入实现。context 视为必需的提示级输入,operationGuidance 为可选补充建议,二者不得作为任务完成的证据,也不得绕过 blocked 状态;与内置指令、用户明确选择或 CLI 控制值冲突时应报告冲突并保留控制值。
实现循环:显示当前任务、做最小且聚焦的改动、立即勾选任务、继续下一项;任务不清、发现设计问题、遇到错误或阻塞、用户打断时暂停并等待指示。
限制:不复制 context 或 operationGuidance 到实现文件或规划工件;不假设具体文件名,以 CLI 输出的 contextFiles 为准;不猜测需求;保持 CLI 控制的 blocked/ready/all_done 行为与完成标准。具体安装与调用方式资料未提供。