mcpField
O
openspec-bulk-archive

openspec-bulk-archive

github.com/full-stack-skills开发189 次安装4 周前更新
代码仓库

关于 openspec-bulk-archive

openspec-bulk-archive 是用于批量归档多个已完成 OpenSpec 变更的技能。它会逐项验证变更、检查规格冲突,并按创建时间顺序处理所选变更。

主要功能

  1. 01列出已完成变更供选择
  2. 02归档前验证各项变更
  3. 03检测规格之间的冲突
  4. 04依据实际实现处理冲突
  5. 05按时间顺序归档变更

适用场景

  1. 01批量归档多个已完成变更
  2. 02检查并行工作后的冲突
  3. 03归档已完成的迭代批次

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-bulk-archive

安装后在 Claude Code 中输入/openspec-bulk-archive确认已加载。

附带文件agents/openai.yaml

详细介绍

OpenSpec 批量归档技能

使用 /opsx:bulk-archive 一次归档多个已完成的变更。该技能会验证每个变更,检测各变更之间的规范冲突,并通过检查实际实现的内容来解决冲突。

适用场景

  • 多个变更已完成,可以归档。
  • 用户说“全部归档”“批量归档”或“清理已完成的变更”。
  • 冲刺或并行工作批次结束后。

前置条件

  • 有多个已完成任务的活跃变更。

工作流

  1. 运行批量归档

    • /opsx:bulk-archive — 列出所有已完成的变更,并提示选择。
    • /opsx:bulk-archive <name1> <name2> ... — 归档指定变更。
  2. 执行内容

    • 列出所有已完成的变更。
    • 归档前验证每个变更。
    • 检测各变更之间的规范冲突(例如,两个变更涉及同一个规范文件)。
    • 通过检查代码库中实际实现的内容来解决冲突。
    • 按时间顺序(根据创建日期)归档。
  3. 确认

    • Agent 会显示清单和冲突解决方案;用户确认后继续。

输出

  • 所有选定的变更都会归档到 openspec/changes/archive/。
  • 增量规范会按时间顺序合并到 openspec/specs/。

后续步骤

  • 使用 openspec-new 开始新的变更。

故障排除

  • 规范冲突:Agent 会检查代码库以解决冲突;确认前请检查解决方案。
  • 未完成的变更:批量归档会提醒存在未完成的任务,但不会阻止归档。

参考资料

评论

支持 Markdown