SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:从 OpenSpec 变更中实现任务,适用于用户想开始实现、继续实现或逐项推进任务清单的场景。

主要能力:选择变更(可指定名称,或从对话上下文推断、仅一个活跃变更时自动选择、歧义时用 openspec list --json 让用户选择);查看状态与 schema;获取 apply 指令(含 contextFiles、进度、任务列表与动态指令);读取上下文文件;循环实现任务并在任务文件中把 - [ ] 改为 - [x];完成后建议归档,遇阻塞建议使用 openspec-continue-change。

使用方式:先运行 openspec status --change "<name>" --json 了解 schemaName、planningHome、changeRoot、actionContext 及任务所在工件;再运行 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度与任务列表;读取 contextFiles 中每个文件路径后开始实现。若使用已注册的 store,先运行 openspec store list --json 获取 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 时祝贺并建议归档;否则进入实现。

限制与护栏:实现前必须读取上下文文件;任务不明确时暂停询问;发现设计问题应暂停并建议更新工件;代码改动保持最小并限定在单个任务范围;每完成一个任务立即更新复选框;遇错误、阻塞或需求不清时暂停,不要猜测;使用 CLI 输出的 contextFiles,不要假定具体文件名。该技能支持“对变更执行动作”的流动模型,可在工件未全部完成、部分实现后或与其他动作交错时调用,并允许在实现暴露设计问题时更新工件。