SuperAPI AI 工具集

openspec-bulk-archive-change

编程与开发

查看项目

更新于 10-16 00:22

技能介绍

用途:将多个已完成的 OpenSpec 变更在一次操作中批量归档,适合同时存在多个并行变更的场景,并智能处理规格冲突。

主要能力:通过 openspec list --json 获取活跃变更;用多选方式让用户挑选变更(始终不自动选择);对每个变更执行 openspec status --change "<name>" --json 收集工件状态、读取 openspec/changes/<name>/tasks.md 统计任务完成情况、检查 openspec/changes/<name>/specs/ 下的增量规格;构建“能力 -> 变更”映射以检测同一能力被多个变更修改的冲突;通过阅读代码库判断哪些规格真正实现,从而决定同步哪个变更、或按时间顺序先后应用;展示合并状态表并仅做一次确认,随后按解析出的顺序执行规格同步与归档,最后输出成功、跳过、失败的汇总结果。

使用方式:由 AI 代理按技能步骤执行,依赖 OpenSpec 命令行工具。典型流程为列出变更、选择、批量校验与冲突解析、确认、执行归档。归档时使用 mkdir -p openspec/changes/archive 与 mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>。

适用场景:需要清理大量已完成并行变更、且变更之间存在规格交叉的项目。

限制:输入无必需项,但会提示用户选择;同一能力被多个变更改动即视为冲突;仅当实现缺失时跳过规格同步并警告;若归档目标目录已存在,该变更归档失败,其余继续;不自动选择变更,必须用户确认。