SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 23:32

技能介绍

用途:在 OpenSpec 实验性工作流中,把已完成的变更正式归档。适用于实现完成后需要收尾、归档变更的场景。

主要能力:检查变更的 artifact 完成状态与任务完成状态;评估 delta 规格与主规格的同步状态;将变更目录移动到 archive 目录,命名格式为 YYYY-MM-DD-<change-name>;输出归档摘要。

使用方式:可选指定变更名,未提供时从上下文推断,模糊则必须让用户从 openspec list --json 的活跃变更中选择,不得猜测或自动选择。用 openspec status --change "<name>" --json 检查 artifact 完成度;读取 tasks.md 统计 - [ ] 与 - [x];用 status JSON 的 artifactPaths.specs.existingOutputPaths 判断是否存在 delta 规格,并与 openspec/specs/<capability>/spec.md 比较。若用户指定 store 或工作位于 store 中,先运行 openspec store list --json 获取 id,再在读写规格与变更的命令(new change、status、instructions、list、show、validate、archive、doctor、context)上附加 --store <id>;无 store 时作用于最近的本地 openspec/ 根目录。归档时执行 mkdir -p "<planningHome.changesDir>/archive",再 mv "<changeRoot>" "<planningHome.changesDir>/archive/YYYY-MM-DD-<name>"。若需同步,通过 Task 工具以 general-purpose 子代理调用 openspec-sync-specs。

限制:artifact 或任务未完成只警告并确认,不阻断归档;目标归档名已存在则报错,需改名或换日期;移动时保留 .openspec.yaml;delta 规格存在时必须先做同步评估并展示合并摘要再询问。