用途:plan-archivist 是 epic-summarizer 的压缩配套技能,用于把已完成的计划树分支归档。epic-summarizer 记录学到了什么,plan-archivist 记录构建了什么。
主要能力:检测调用方传入的 NODE_ID,要求其为 T2 或 T1 且状态为 done,否则拒绝;读取该节点及全部后代(Story、Task);生成归档摘要,包含一行意图、子节点摘要(id、状态、AC 数量、完成日期)、验收标准汇总(每个 Story 的通过/总数)、任务总数(完成/丢弃/跳过)、trace 大小与幻觉计数(若存在 trace);写入 .claude/plans/archive/{NODE_ID}.summary.md;更新父节点 children 列表,用归档引用替换被剪除的 ID;向 history.jsonl 追加 branch_archived 事件,含 archive_path 与 pruned 数量。
使用方式:命令 /aura-frog:plan-archive 是唯一消费者;hooks/feature-done-trigger-archive.cjs 在 T2 完成时同时调用 summarizer 与 archivist。默认保留原始文件,--prune 为可选剪除;若任一后代不是 done 或 archived 则拒绝剪除;即使剪除中途失败也始终保留归档摘要;永不剪除 T1 Initiative 或 T0 Mission 节点。
限制:不读写 .claude/memory/;不删除 checkpoint;不修改未剪除节点的 frontmatter(仅 archived 状态转换与 revision++);不支持解压归档,恢复需通过 /aura-frog:plan-undo 针对 checkpoint 进行。相关规则见 plan-lifecycle.md 与 checkpoint-discipline.md。