用途:从 OpenSpec 变更中实现任务,适用于开始实现、继续实现或逐项推进任务的场景。
主要能力:选择变更、检查状态与 schema、获取 apply 指令、读取上下文文件、展示进度、逐项实现任务并勾选完成,最后汇总进度。
使用方式:可选指定变更名;未提供时从对话上下文推断,只有一个活跃变更时自动选择,含糊时运行 npx openspec list --json 获取可用变更并让用户选择。随后运行 npx openspec status --change "<name>" --json 了解 schemaName 与任务所在产物,再运行 npx openspec instructions apply --change "<name>" --json 获取上下文文件路径、进度与任务列表。读取 contextFiles 后展示进度并逐项实现,完成后将任务文件中 - [ ] 改为 - [x]。
状态处理:state 为 blocked 时提示使用 openspec-continue-change;all_done 时建议归档;否则继续实现。
限制与护栏:实现前必须读取上下文文件;任务含糊、发现设计问题、遇到错误或阻塞时暂停并询问,不猜测;代码改动保持最小并限定在单个任务范围;使用 CLI 输出的 contextFiles,不假设文件名。该技能支持“对变更执行动作”的流动模式,可在任意时间调用,允许建议更新产物。