用途:从 OpenSpec 变更中实现任务,适合开始、继续或推进实现工作。若用户指定变更名则直接使用;否则从对话推断、仅有单个活动变更时自动选择,含糊时通过 openspec list --json 列出并请用户选择。选择后需告知使用哪个变更及如何覆盖。
主要能力:先用 openspec status --change "<name>" --json 了解 schema、规划范围与编辑约束,再用 openspec instructions apply --change "<name>" --json 获取上下文文件路径、进度、任务列表与动态指令。随后阅读 contextFiles 中列出的文件,展示进度,逐项实现任务并把 - [ ] 改为 - [x],循环直到完成或受阻。
存储选择:若命名了 store 或工作位于其中,先运行 openspec store list --json 获取 id,再在读取或写入 spec、change 的命令上追加 --store <id>,选定后保持粘性;未指定时命令作用于最近的本地 openspec/ 根目录。
上下文与指导:context 为必需提示级输入,需应用其中项目事实与约定;operationGuidance 为可选建议,适用且兼容时采纳。二者不构成任务完成的证据,不得替代内置指令或绕过 blocked 状态;若与内置指令、用户明确选择或 CLI 控值冲突,应报告冲突并保留控制值。
状态处理:state 为 blocked 时提示使用继续变更技能或查看下一工件;all_done 时祝贺并建议归档;否则进入实现。实现中保持改动最小且聚焦,任务不明确、发现设计问题或遇错误时暂停等待指示。
限制:不编造未提供的功能或步骤;所有命令与文件路径以资料为准。