| name | openspec-archive-change |
| description | 归档实验性工作流中已完成的变更。当用户想要在实现完成后最终确定并归档变更时使用。 |
| license | MIT |
| compatibility | 需要 openspec CLI。 |
| metadata | {"author":"openspec","version":"1.0","generatedBy":"1.1.1-1"} |
归档实验性工作流中已完成的变更。
输入：可选指定变更名称。如果省略，检查是否可以从对话上下文中推断。如果模糊或不明确，你必须提示获取可用变更。
步骤
-
如果没有提供变更名称，提示选择
运行 openspec-cn list --json 获取可用变更。使用 AskUserQuestion tool 让用户选择。
仅显示活动变更（未归档的）。
如果可用，包括每个变更使用的 Schema。
重要提示：不要猜测或自动选择变更。始终让用户选择。
-
检查产出物完成状态
运行 openspec-cn status --change "<name>" --json 检查产出物完成情况。
解析 JSON 以了解：
schemaName：正在使用的工作流artifacts：产出物列表及其状态（done 或其他）
如果有任何产出物未 done：
- 显示列出未完成产出物的警告
- 使用 AskUserQuestion tool 确认用户是否要继续
- 如果用户确认，则继续
-
检查任务完成状态
阅读任务文件（通常是 tasks.md）以检查未完成的任务。
统计标记为 - [ ]（未完成）与 - [x]（已完成）的任务。
如果发现未完成的任务：
- 显示警告，显示未完成任务的数量
- 使用 AskUserQuestion tool 确认用户是否要继续
- 如果用户确认，则继续
如果没有任务文件存在： 继续，无需任务相关警告。
-
评估增量规范同步状态
检查 openspec/changes/<name>/specs/ 中的增量规范。如果不存在，则在没有同步提示的情况下继续。
如果存在增量规范：
- 将每个增量规范与其在
openspec/specs/<capability>/spec.md 对应的各主规范进行比较
- 确定将应用哪些更改（添加、修改、移除、重命名）
- 在提示前显示综合摘要
提示选项：
- 如果需要更改：“立即同步（推荐）”、“归档而不同步”
- 如果已同步：“立即归档”、“仍然同步”、“取消”
如果用户选择同步，执行 /opsx:sync 逻辑（使用 openspec-sync-specs 技能）。无论选择如何，都继续归档。
-
执行归档
如果归档目录不存在，则创建它：
mkdir -p openspec/changes/archive
使用当前日期生成目标名称：YYYY-MM-DD-<change-name>
检查目标是否已存在：
- 如果是：失败并报错，建议重命名现有归档或使用不同日期
- 如果否：将变更目录移动到归档
mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>
-
显示摘要
显示归档完成摘要，包括：
- 变更名称
- 使用的 Schema
- 归档位置
- 规范是否已同步（如果适用）
- 关于任何警告的说明（未完成的产出物/任务）
成功时的输出
## 归档完成
**变更：** <change-name>
**模式：** <schema-name>
**归档至：** openspec/changes/archive/YYYY-MM-DD-<name>/
**规范：** ✓ 已同步到主规范（或 "无增量规范" 或 "同步已跳过"）
所有产出物已完成。所有任务已完成。
防护措施
- 如果未提供变更，始终提示选择
- 使用产出物图（openspec status --json）进行完成度检查
- 不要在警告时阻止归档 - 只需告知并确认
- 移动到归档时保留 .openspec.yaml（它与目录一起移动）
- 显示清晰的操作摘要
- 如果请求同步，使用 openspec-sync-specs 方法（代理驱动）
- 如果存在增量规格说明，始终运行同步评估并在提示前显示综合摘要
