sdd-archive

sdd-archive

关闭已完成的 SDD 变更并保存归档报告。

触发条件：/sdd-archive <change-name>、归档变更、完成 SDD 周期、关闭变更、sdd archive

---

用途

归档是 SDD 周期的最后一步。它会验证完整性、保存关闭记录并更新项目记忆层。此操作不可逆——执行前我会向用户确认。

技能解析

按以下顺序：项目本地 → 全局

1. .claude/skills/sdd-archive/SKILL.md     (project-local — highest priority)
2. ~/.claude/skills/sdd-archive/SKILL.md   (global catalog — fallback)

完整算法请参阅 docs/SKILL-RESOLUTION.md。

---

---

Claude 执行接线

以下说明将上文与工具无关的逻辑绑定到 Claude Code 执行框架。它们属于不适用于其他工具的执行层。

• 完整性检查／旧版回退 — 以磁盘文件是否存在为准。如果磁盘文件缺失，则回退到 mem_search(query: "sdd/{change-name}/{type}")；如果 mem_search 返回结果，则该工件视为存在。
• 读取验证报告 — 使用执行框架的 Read("docs/sdd/{change-name}/verify-report.md")。 如果磁盘文件缺失（旧版变更），则回退到 mem_search(query: "sdd/{change-name}/verify-report") → mem_get_observation(id)。
• 步骤 4 关闭记录持久化 — 优先写入磁盘： Write("docs/sdd/{change-name}/archive-report.md", <closure summary>)，然后 使用 topic_key: sdd/{change-name}/archive-report、 type: architecture、project: {project} 执行 mem_save 保存指针。如果 Engram MCP 无法访问，则仅写入磁盘工件，并跳过 engram 指针。
• 步骤 5 记忆更新 — 读取 ~/.claude/skills/memory-manage/SKILL.md，并内联运行 /memory-manage 的“更新”流程；失败不会阻塞后续操作。
• 步骤 6 前置条件（a） — 调用 mem_search(topic_key: "sdd/<change>/archive-report", project: <canonical-project>)； 未找到时，在阻塞前重试一次 mem_save。移动操作使用 Write("docs/sdd/_archived/<change>-archive-report.md", ...)；删除操作使用 git rm -r docs/sdd/<change>/ 然后执行 rm -rf docs/sdd/<change>/。
• 具备能力的层级委派 — 轻量级层级为 model: haiku。工件创建子步骤（步骤 3）必须委派给一个新启动的、使用 model: fable 的子 Agent（编排器会根据模型回退链替换为 sonnet）。其他所有子步骤仍使用 model: haiku。创建的工件只有在手动运行 install.sh 后才会到达 ~/.claude/。
• 编排器输出 — 将中立的输出契约作为编排器所需的 JSON 块返回；artifacts 包含 engram:sdd/{change-name}/archive-report。