用途:从 OpenSpec 变更中实现任务,适用于开始实现、继续实现或逐项推进任务。
主要能力:可选指定变更名;未指定时从对话上下文推断,或仅有一个活跃变更时自动选择;若有歧义,运行 openspec list --json 并用 AskUserQuestion 让用户选择。通过 openspec status --change "<name>" --json 了解 schema 和任务所在工件,通过 openspec instructions apply --change "<name>" --json 获取上下文文件路径、进度、任务列表和动态指令。支持 blocked、all_done 等状态分支。
使用方式:先选择变更并宣布使用哪个变更及如何覆盖(如 /opsx:apply <other>)。检查状态与 apply 指令后,读取 CLI 输出中的 contextFiles(不同 schema 可能为 proposal/specs/design/tasks 或 spec/tests/implementation/docs)。展示 schema、N/M 进度和剩余任务,然后循环实现:显示当前任务、做所需代码修改、保持最小范围、立即把任务文件中 - [ ] 改为 - [x]。完成后汇总本次完成项和总进度;全部完成时建议归档;暂停时说明原因并等待指示。
适用场景:OpenSpec 工作流中逐项落实变更任务,支持在所有工件完成前、部分实现后或与其他动作交错调用。若 state 为 blocked,提示使用 openspec-continue-change;若 all_done,祝贺并建议归档。
限制与规则:开始前必须读取上下文文件;任务不明确时暂停询问;实现发现设计问题时暂停并建议更新工件;不得猜测;代码修改保持最小且聚焦;出错或阻塞时暂停等待指引;使用 CLI 输出的 contextFiles,不假设固定文件名。输出格式包含实现中、完成、暂停三类模板。