Openspec Bulk Archive Change

检测规格说明冲突

构建 capability -> [涉及它的变更] 映射：

auth -> [change-a, change-b]  <- 冲突（2+ 个变更）
api  -> [change-c]            <- 正常（仅 1 个变更）

当 2+ 个选定的变更具有相同能力的增量规格说明时，存在冲突。

代理式解决冲突

对于每个冲突，调查代码库：

a. 读取增量规格说明 从每个冲突的变更中了解每个声称添加/修改的内容

b. 搜索代码库 寻找实现证据：

• 查找实现每个增量规格说明中需求的代码
• 检查相关文件、函数或测试

c. 确定解决方案：

• 如果只有一个变更实际实现 -> 同步该变更的规格说明
• 如果两者都实现 -> 按时间顺序应用（旧的先，新的覆盖）
• 如果两者都未实现 -> 跳过规格说明同步，警告用户

d. 记录解决方案 对于每个冲突：

• 应用哪个变更的规格说明
• 按什么顺序（如果两者都有）
• 原理（在代码库中找到了什么）

显示合并状态表

显示汇总所有变更的表：

| 变更                 | 产出物    | 任务  | 规格说明 | 冲突      | 状态   |
|---------------------|-----------|-------|---------|-----------|--------|
| schema-management   | 完成      | 5/5   | 2 增量  | 无        | 就绪   |
| project-config      | 完成      | 3/3   | 1 增量  | 无        | 就绪   |
| add-oauth           | 完成      | 4/4   | 1 增量  | auth (!)  | 就绪*  |
| add-verify-skill    | 剩余 1    | 2/5   | 无      | 无        | 警告   |

对于冲突，显示解决方案：

* 冲突解决方案：
  - auth 规格说明：将先应用 add-oauth 然后 add-jwt（两者都已实现，按时间顺序）

对于未完成的变更，显示警告：

警告：
- add-verify-skill：1 个未完成产出物，3 个未完成任务

确认批量操作

使用 AskUserQuestion 工具进行单次确认：

• "归档 N 个变更？"根据状态提供选项
• 选项可能包括：
  • "归档所有 N 个变更"
  • "仅归档 N 个就绪变更（跳过未完成的）"
  • "取消"

如果存在未完成的变更，请明确说明它们将带着警告被归档。

对每个确认的变更执行归档

按确定的顺序处理变更（遵循冲突解决方案）：

a. 如果存在增量规格说明则同步规格说明：

• 使用 openspec-sync-specs 方法（代理驱动的智能合并）
• 对于冲突，按已解决的顺序应用
• 跟踪是否已完成同步

b. 执行归档：

mkdir -p openspec/changes/archive
mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>

c. 跟踪每个变更的结果：

• 成功：成功归档
• 失败：归档期间出错（记录错误）
• 跳过：用户选择不归档（如适用）

显示摘要

显示最终结果：

## 批量归档完成

已归档 3 个变更：
- schema-management-cli -> archive/2026-01-19-schema-management-cli/
- project-config -> archive/2026-01-19-project-config/
- add-oauth -> archive/2026-01-19-add-oauth/

跳过 1 个变更：
- add-verify-skill（用户选择不归档未完成的）

规格说明同步摘要：
- 4 个增量规格说明已同步到主规格说明
- 1 个冲突已解决（auth：按时间顺序应用两者）

如果有任何失败：

失败 1 个变更：
- some-change：归档目录已存在