SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-15 22:11

技能介绍

用途:从 OpenSpec 变更中实现任务,适合用户要开始实现、继续实现或逐项推进任务时使用。

主要能力:选择变更(可指定名称,或从对话上下文推断、仅一个活跃变更时自动选择,歧义时用 openspec list --json 列出并让用户选择);查看状态与 schema;获取 apply 指令(含 contextFiles、进度、任务列表与动态指令);读取上下文文件;逐项实现任务并把任务文件中的 - [ ] 改为 - [x];输出实现中、完成、暂停三种状态报告。

使用方式:若使用已注册的 store,先运行 openspec store list --json 获取 id,再在读写 specs 与 changes 的命令(new change、status、instructions、list、show、validate、archive、doctor、context)上加 --store <id>,其他命令不带该参数;无 store 时作用于最近的本地 openspec/ 根目录。常用命令:openspec status --change "<name>" --json、openspec instructions apply --change "<name>" --json。

适用场景:spec-driven 等 schema 下的变更实现,可在所有产物完成前、部分实现后或与其他动作交错调用。

限制与约束:开始前必须读取 contextFiles 中的文件,不假设文件名;任务不明确、发现设计问题、遇到错误或阻塞时暂停并询问,不猜测;改动保持最小且限定在单个任务范围;state 为 blocked 时建议使用 openspec-continue-change,all_done 时建议归档。具体 schema 差异与文件清单以 CLI 输出为准。