归档实验性工作流中已完成的变更。

输入：可选指定变更名称。如果省略，检查是否可以从对话上下文中推断。如果模糊或不明确，你必须提示获取可用变更。

步骤

如果没有提供变更名称，提示选择

运行 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 确认用户是否要继续

• 如果用户确认，则继续

如果没有任务文件存在： 继续，无需任务相关警告。

Assess delta spec sync state

Check for delta specs at openspec/changes/<name>/specs/ . If none exist, proceed without sync prompt.

If delta specs exist:

• Compare each delta spec with its corresponding main spec at openspec/specs/<capability>/spec.md

• Determine what changes would be applied (adds, modifications, removals, renames)

• Show a combined summary before prompting

Prompt options:

• If changes needed: "Sync now (recommended)", "Archive without syncing"

• If already synced: "Archive now", "Sync anyway", "Cancel"

If user chooses sync, execute /opsx:sync logic (use the openspec-sync-specs skill). Proceed to archive regardless of choice.

执行归档

如果归档目录不存在，则创建它：

mkdir -p openspec/changes/archive

使用当前日期生成目标名称：YYYY-MM-DD-<change-name>

检查目标是否已存在：

• 如果是：失败并报错，建议重命名现有归档或使用不同日期

• 如果否：将变更目录移动到归档

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

显示摘要

显示归档完成摘要，包括：

• 变更名称

• 使用的 Schema

• 归档位置

• 规范是否已同步（如果适用）

• 关于任何警告的说明（未完成的产出物/任务）

成功时的输出

归档完成

Change: <change-name> Schema: <schema-name> Archived to: openspec/changes/archive/YYYY-MM-DD-<name>/ Specs: ✓ Synced to main specs (or "No delta specs" or "Sync skipped")

所有产出物已完成。所有任务已完成。

防护措施

• 如果未提供变更，始终提示选择

• 使用产出物图（openspec status --json）进行完成度检查

• 不要在警告时阻止归档 - 只需告知并确认

• 移动到归档时保留 .openspec.yaml（它与目录一起移动）

• 显示清晰的操作摘要

• 如果请求同步，使用 openspec-sync-specs 方法（代理驱动）

• 如果存在增量规格说明，始终运行同步评估并在提示前显示综合摘要