openspec-archivelisted

# OpenSpec Archive (归档器) > **版本**: 1.1.0 | **十步循环**: D.2 > **更新**: 2026-07-05 - #95 归档 gate 硬化: Step1 扩展 C 分级证据闸 (block 死代码 / warn 模糊) + 新增 Step7 D auto-issue (归档不吞未完成) > **历史**: 2026-02-08 - 初始版本，修复 CLI 归档位置 bug ## 快速开始 ### 我应该使用这个 Skill 吗？ **使用场景**: - Spec 所有任务已完成，需要归档 - Phase D.2 收尾阶段 - 清理已完成的变更 **不使用场景**: - Spec 仍有活跃任务 → 完成任务后再归档 - 需要继续修改 Spec → 保持变更活跃状态 --- ## 核心功能 | 功能 | 说明 | |------|------| | **状态验证** | 检查 Spec 完成状态和任务完成度 (#134 完成度二元判定) | | **完成声称真实性证据闸 (#95)** | C 分级 (🔴 block 高置信死代码 / 🟠 warn 模糊声称) — 验 tasks.md `[x]` 代码集成类声称有无真实生产语义引用 | | **执行归档** | 调用 openspec archive CLI | | **自动修正** | 修正 CLI 的归档目录位置 bug | | **清理验证** | 清理空目录，验证最终结果 | | **D auto-issue (#95)** | 归档不吞未完成 — deferred/unverified 项自动建 Forgejo tracker issue (幂等 + headless 默认) | --- ## ⚠️ 已知 Bug: OpenSpec CLI 归档位置错误 **问题**: `openspec archive` CLI 命令有 bug，输出到错误位置： ``` ❌ CLI 输出: openspec/changes/archive/YYYY-MM-DD-{feature}/ ✅ 正确位置: openspec/archive/YYYY-MM-DD-{feature}/ ``` **本 Skill 会自动修正此问题**。 --- ## 正确的目录结构 ``` openspec/ ├── archive/ # ✅ 正确的归档位置 │ └── YYYY-MM-DD-{feature}/ │ ├── proposal.md │ ├── tasks.md │ └── detailed-tasks.yaml └── changes/ # 活跃变更 └── {active-feature}/ ``` --- ## 执行流程 ### 输入 ```yaml change_name: required: true description: 要归档的变更目录名 example: "cloudflare-access-auto-handling" options: skip_verification: false # 仅跳过 tasks.md [x] 校验 (v1.42.0+ 收口: 不绕过 Status 归一化 gate) keep_changes_copy: false