用途:从 OpenSpec 变更中实现任务,适用于用户想开始实现、继续实现或逐项推进任务的场景。
主要能力:选择变更(可指定名称,或从对话上下文推断、仅一个活跃变更时自动选择,歧义时用 openspec list --json 列出并让用户选择);用 openspec status --change "<name>" --json 了解 schemaName、planningHome、changeRoot、actionContext 及任务所在工件;用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度与任务状态;读取 contextFiles 中列出的文件后逐项实现,并把任务文件中 - [ ] 改为 - [x]。
存储选择:若用户指定 store 或工作位于某个 store,先运行 openspec store list --json 获取已注册 store id,再在读写 specs 与 changes 的命令(new change、status、instructions、list、show、validate、archive、doctor、context)上加 --store <id>;其他命令不接受该标志。无 store 时命令作用于最近的本地 openspec/ 根目录。
状态处理:state 为 blocked(缺少工件)时提示改用 openspec-continue-change;state 为 all_done 时祝贺并建议归档;否则继续实现。实现中保持改动最小、聚焦单个任务,任务不明确、发现设计问题或遇到错误阻塞时暂停并等待指示。
限制:资料未提供安装方式、收费、平台与效果信息;具体文件依 schema 而定,应使用 CLI 输出的 contextFiles,不要假设固定文件名。