knowledge-groomlisted

# Knowledge Groom > **本地执行说明**：本 skill 标记 `disable-model-invocation`（防 agent 自发启动批量改库）——skill 工具加载会报 "not available for model invocation"，这是预期。用户明确要求 groom 时，agent 直接 `read` 本文件手动遵循流程即可，流程完整性不受影响；或用户输入 `/skill:knowledge-groom` 直接触发。 体系的演化引擎。不加控制的增长会摧毁检索效率——这个 skill 是知识库的"免疫系统 + 清道夫"。 ## 触发 手动运行，建议每周一次；连续四周无新 postmortem 时可改双周——**这是人的节奏判断，不是脚本行为**（本仓没有 cadence 实现，别把它读成自动调度）。 **触发场景区分**： - **人工使用场景（默认周批）**：人通过 diagnose/to-postmortem 等沉淀的草稿——攒 inbox 到周批统一处理，人审 ~30s/条后升格提 PR（人的注意力是稀缺资源，批处理是预算分配， 原则九）； - **自动化 ingest 场景（可直接升格，不等周批）**：issue-ingest/S2 补 case 等自动化 链路产出的草稿——verification 链完整（upstream-fix-merged 等外部验证）+ agent 已过 语义校验 + pre-triage 判别完成，质量前提与人工场景不同，**产出后可直接走本流程升格 入库提 PR**（同 2026-W36 round2 全自动轮 22 case 升格先例）。前提：owner 已预授权该 自动化源（issue-ingest 链路本身即 owner 配置的持续管道，其产出视为预授权）。草稿头 注释带完整 pre-triage/verification 证据 → 复核确认而非重判。 ## groom 成本预算与脚本先行（token 预算纪律：确定性环节脚本先行、agent 只读摘要） 目标：单次 groom（含 inbox 段与 references 维护段）token 降至可读摘要量级（<30K）， 功能不缺失。纪律： 1. **确定性环节一律跑脚本、只读输出摘要，不读全量原文**： - 引用完整性/悬挂/role：`scripts/verify_references.py --check`（输出进摘要）； - 索引/容量：`scripts/index_counts.py`（条数与逐格容量，现算）+ `scripts/capacity_health.py`（溢出/健康）输出进摘要； - 引用可观测性：`scripts/trace_metrics.py`（R6）；tag 聚类：读 `_index` tags 聚合（R8，零 token 机械）； - reference 规模/退化（R7）：按文件数/metrics 判断，不逐文件读。 2. **全量重扫默认关闭，改信号触发**： - R3（引用发现，需扫 case 正文）：**默认不跑**——仅当本轮 新升格 case ≥5 且 owner 要求时执行 （R3 本就是可选项；防"每周全量扫 128 case 正文"常设成本）； - confidence 重算（步骤 4）：只对"结算/升格有变化的 case"重算（3.5/3.5b 输出 diff 涉及 +