plan-archivist

用途

plan-archivist 用于压缩一个已完成的计划树分支，输出 .claude/plans/archive/{NODE_ID}.summary.md，并可选删除原始节点文件。原始文件可由 checkpoint 历史保留恢复。它是 epic-summarizer 的压缩配套技能，状态为 v3.7.0-alpha.4。

与 epic-summarizer 的区别

输出：epic-summarizer 写 .claude/memory/permanent_memory.md（持久经验）；plan-archivist 写 .claude/plans/archive/{NODE_ID}.summary.md（计划树压缩）。
范围：前者记录跨领域决策与坑点；后者做分支级摘要，说明交付了什么、对应哪些验收标准（AC）与任务。
生命周期：两者均跨 reset 保留。
token 预算：前者 ≤500/Epic、总计 ≤8000；后者 ≤300/分支，无全局上限（每个归档分支一个文件）。

概括而言：epic-summarizer 捕获学到了什么，plan-archivist 捕获构建了什么。

主要行为

检测：调用方传入 <NODE_ID>，该节点必须为 T2 或 T1 层级且状态为 done，否则拒绝。
读取该节点及其所有后代（Stories、Tasks）。
撰写归档摘要，包含：一行意图；子节点摘要（id、状态、AC 数量、完成日期）；验收标准汇总（每个 Story 的通过/总数）；任务总数（done/discarded/skipped）；trace 规模与幻觉数量（如存在 trace）。
写入 .claude/plans/archive/{NODE_ID}.summary.md。
可选清理（仅在 --prune 时）：删除原始 Story/Task 文件（必要时可从 checkpoint 取回）。若任一下级节点不处于 done 或 archived 状态则拒绝清理。
更新父节点的 children 列表，把被清理的 ID 替换为归档引用。
追加 history.jsonl 事件：event: branch_archived，含 archive_path 与 pruned 数量。

清理规则

默认保留原始文件，--prune 需显式开启。
即使清理中途失败，也始终保留 archive/{NODE_ID}.summary.md。
永不清理 T1 Initiative 或 T0 Mission 节点（顶层节点累积，不做归档清理）。

归档文件结构

摘要文件包含 YAML frontmatter，字段示例：archived_id、tier、parent、archived_at（ISO-8601）、archived_by、status、original_revision、intent、acceptance_summary_pass_rate、children_count（stories/tasks/discarded）、trace_summary（events、hallucinations_flagged、recovered）。正文包含一段交付说明、Stories 列表（含 AC 通过情况）、任务汇总与交叉引用（permanent_memory.md、checkpoints 保留说明）。

不做什么

不读写 .claude/memory/（属 epic-summarizer 职责）。
不删除 checkpoint（遵循 checkpoint-discipline.md 保留策略）。
不对未清理节点的 frontmatter 做改动（仅 archived 状态转换与 revision++）。
不解压归档；恢复通过 /aura-frog:plan-undo 针对 checkpoint 完成。

关联

规格：§9.4。
配套代理：epic-summarizer（先运行，archivist 后运行）。
命令：/aura-frog:plan-archive 是唯一调用方。
钩子：hooks/feature-done-trigger-archive.cjs 在 T2 done 时调用 summarizer 与 archivist。
规则：rules/workflow/plan-lifecycle.md 定义 archived 为终态；rules/workflow/checkpoint-discipline.md 要求被清理节点须有 checkpoint 历史。

适用场景与限制

适用于采用分层计划树工作流、需要在分支完成后压缩计划文件并保留摘要的场景。使用前提是节点层级与状态符合要求；默认不删除原始文件，清理需显式开启且受状态约束；它不负责长期记忆写入，也不提供归档解压能力。