SuperAPI AI 工具集

openspec-bulk-archive-change

通用与其它

查看项目

更新于 10-15 23:44

技能介绍

用途:批量归档多个已完成的 OpenSpec 变更,适合同时存在多个并行变更需要收尾的场景。

主要能力:通过 openspec list --json 获取活动变更;用多选方式让用户选择要归档的变更(不自动选择);对每个变更运行 openspec status --change "<name>" --json 收集工件状态、任务完成度与 delta 规格;检测同一能力被多个变更触及的规格冲突,并通过检索代码库判断实际实现情况来解析冲突;展示汇总状态表并一次性确认后执行归档。

使用方式:先获取活动变更,再提示选择,随后批量校验、检测并解析冲突、确认、逐个执行归档。归档时同步规格(若存在 delta 规格),并执行 mkdir -p "<planningHome.changesDir>/archive" 与 mv "<changeRoot>" "<planningHome.changesDir>/archive/YYYY-MM-DD-<name>"。

冲突处理:仅一个变更已实现则只同步该变更规格;两者都已实现则按时间顺序应用(较新覆盖较旧);都未实现则跳过规格同步并警告。

限制:若某变更的 actionContext.mode 为 workspace-planning,则不支持工作区批量归档,需在同步规格或移动变更前停止,不得回退到仓库本地路径或编辑关联仓库。归档目标已存在时该变更失败但继续处理其他变更。移动时保留 .openspec.yaml。