SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:在 OpenSpec 实验性工作流中,把已实现完成的变更正式归档。适用于用户希望收尾并归档某个 change 的场景。

主要能力:选择目标变更(可指定名称,或从上下文推断、自动选择唯一活动变更,歧义时用 openspec list --json 让用户选择);用 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;对比 delta 规格与主规格,评估需要应用的增删改重命名;按用户选择执行同步或直接归档;将变更目录移动到 archive 并输出摘要。

使用方式:若涉及已注册的 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>,该选择在后续流程中保持。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文,失败或返回无效 JSON 时继续流程。同步前需运行 openspec instructions specs --change "<name>" --json 并成功返回,再内联执行 openspec-sync-specs 工作流并等待完成,随后重新校验各能力是否已同步。归档时创建 archive 目录,目标名已带 YYYY-MM-DD- 前缀则沿用,否则前置当前日期,已存在则报错;用 mv 移动 changeRoot。

限制:产物或任务未完成只警告并需用户确认,不阻塞归档;同步失败或校验不匹配时必须停止,不得归档;同步进行中不得移动 changeRoot;不得把运行时上下文、操作指引或产物规则文本原样写入输出文件;无 store 时命令作用于最近的本地 openspec/ 根目录。