SuperAPI AI 工具集

openspec-bulk-archive-change

编程与开发

查看项目

更新于 10-22 09:57

技能介绍

用途:批量归档多个已完成的变更,减少在并行变更较多时逐个归档的重复操作。

主要能力:

  1. 获取活动变更并让用户多选(不自动选择,支持任一数量选择)。
  2. 批量校验:对每个变更运行 openspec status --change "<name>" --json 获取 schemaName 与 artifacts 状态,读取 tasks.md 统计未完成任务,检查 specs 目录中各项能力规范及需求名。
  3. 冲突检测:当两个及以上被选变更包含同一能力的 delta 规范时判定为冲突,并构建能力到变更的映射。
  4. 冲突解析:读取各冲突变更的 delta 规范,在代码库中查找实现证据,据此决定是仅同步已实现的变更规范、按时间顺序叠加应用,还是在均未实现时跳过同步并警告。
  5. 汇总展示:以表格呈现变更、产物、任务、规范与冲突状态,并列出警告。
  6. 单次确认后执行:先按解析顺序同步规范,再执行 mkdir -p openspec/changes/archive 与 mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name> 完成归档。
  7. 结果输出:分别报告已归档、跳过与失败项及规范同步摘要;归档目标已存在时该变更失败但继续处理其他变更。

使用方式:该技能无需输入参数,运行后通过交互提示选择变更,确认批量操作后自动执行。无活动变更时提示使用 /opsx-new 创建新变更。

适用场景:同时存在多个并行变更、且希望一次性收尾归档时。

限制:需在具备 OpenSpec 项目结构的环境中使用;冲突解决依赖对代码库实现情况的检索判断;未完成的变更仍可归档但会给出警告;归档目录使用当前日期前缀,目标已存在则该项归档失败。