用途:清理 LEAF 文档,使其读起来像一份已完成的报告而非过程记录。判断标准接近费曼式:保留必要的 why、what、证据、决策、风险与下一步输入,删除过期选项、废弃分支、重复推理、模板残留和无用的状态对话。
主要能力:仅针对 LEAF 文档质量。清理前会先读取 git status --short --branch、leaf doctor、leaf review <slug>,确定最小清理范围,例如关闭前的单个关口文件、发生漂移的 00-status.md,或整体连贯性审查。编辑关口文档前运行 leaf checkpoint <slug> --<gate>。
迁移:该技能也是 leaf doctor 旧布局问题的修复入口,处理 old_stage_dir_present、pressed_stage_dir_present、legacy_state_field、legacy_fall_reason_field 等发现;迁移只改变位置和字段名,不重写含义,迁移后需重跑 leaf doctor 确认。若 slug 冲突则停止并询问。
清理与检查:先通读再改写,围绕当前结论组织内容,将旧方案压缩为一句话,删除过期 TODO 和模板标题,明确假设与未决限制。额外检查 drift、surface、archive、fallen。
评审与通过标准:尽量由独立子代理按给定评分标准评审,返回 keep、cut、unclear、drift/surface、verdict;无子代理时自行评审并标注。通过条件包括新代理一次阅读即可说出 why 和 what、当前决策比历史更易找到、状态与实际产物一致、无删除改变来源事实、leaf doctor 仍报告工作区可用。
限制:不执行产物工作、不创建 wt 产物、不决定 press/fall 关闭、不维护外部系统。解析器字段、路径、命令名、代码标识符与引用原文保持原样,除非清理明确针对该字段。