openspec-archive-change

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