关于 openspec-bulk-archive
openspec-bulk-archive 是用于批量归档多个已完成 OpenSpec 变更的技能。它会逐项验证变更、检查规格冲突,并按创建时间顺序处理所选变更。
主要功能
- 01列出已完成变更供选择
- 02归档前验证各项变更
- 03检测规格之间的冲突
- 04依据实际实现处理冲突
- 05按时间顺序归档变更
适用场景
- 01批量归档多个已完成变更
- 02检查并行工作后的冲突
- 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 一次归档多个已完成的变更。该技能会验证每个变更,检测各变更之间的规范冲突,并通过检查实际实现的内容来解决冲突。
适用场景
- 多个变更已完成,可以归档。
- 用户说“全部归档”“批量归档”或“清理已完成的变更”。
- 冲刺或并行工作批次结束后。
前置条件
- 有多个已完成任务的活跃变更。
工作流
-
运行批量归档
/opsx:bulk-archive— 列出所有已完成的变更,并提示选择。/opsx:bulk-archive <name1> <name2> ...— 归档指定变更。
-
执行内容
- 列出所有已完成的变更。
- 归档前验证每个变更。
- 检测各变更之间的规范冲突(例如,两个变更涉及同一个规范文件)。
- 通过检查代码库中实际实现的内容来解决冲突。
- 按时间顺序(根据创建日期)归档。
-
确认
- Agent 会显示清单和冲突解决方案;用户确认后继续。
输出
- 所有选定的变更都会归档到
openspec/changes/archive/。 - 增量规范会按时间顺序合并到
openspec/specs/。
后续步骤
- 使用 openspec-new 开始新的变更。
故障排除
- 规范冲突:Agent 会检查代码库以解决冲突;确认前请检查解决方案。
- 未完成的变更:批量归档会提醒存在未完成的任务,但不会阻止归档。
参考资料
评论
支持 Markdown