outline-budgeter

大纲预算编排（NO PROSE）

触发条件与路由

• 触发词：大纲预算、合并章节、章节太多、H3 爆炸、大纲预算、合并小节、大纲太碎。
• 适用场景：存在 outline/outline.yml，但会导致章节内容单薄（H2/H3 太多）；在 section-mapper 之前（或之后立即）使用。

目的：防止综述中最常见的失败模式：H3 爆炸（过多细小的子章节），导致 PDF 只有大纲，没有实质内容。

此技能会将 outline/outline.yml 重写为更像论文的预算：

• 最终目录目标：约 6–8 个 H2 章节（引言 / 相关工作 + 3–4 个核心章节 + 讨论 + 结论）
• H3 目标：更少、更充实的子章节（按 draft_profile 区分：course_paper<=6，survey<=10，deep<=12）

重要：讨论 / 结论会在 C5 合并时追加（全局章节），因此大纲本身通常应不超过 6 个 H2。

输入

• outline/outline.yml
• 可选（有助于基于证据进行合并）：
  • queries.md（可选：如果其中设置了 draft_profile，则据此选择 H3 预算）
  • outline/mapping.tsv
  • outline/coverage_report.md
  • GOAL.md

输出

• outline/outline.yml（原地更新）
• outline/OUTLINE_BUDGET_REPORT.md（仅使用项目符号；记录合并内容及原因）

工作流（NO PROSE）

1. 阅读大纲并计算简单的预算快照：

• 如果 queries.md 设置了 draft_profile（course_paper/survey/deep），则据此确定 H3 预算目标。
• H2 数量（不包括大纲中没有的讨论 / 结论）
• H3 总数
• 每个 H2 章节的 H3 数量

2. 制定合并计划（结构优先、结合证据）：

• 优先合并主题维度 / 关键词相似的相邻 H3。
• 如果存在 mapping.tsv，优先合并映射覆盖较弱的 H3。
• 如果存在 outline/coverage_report.md（来自 outline-refiner），则据此识别覆盖较弱或复用率较高的子章节并进行合并。
• 使用 GOAL.md 作为范围约束：避免合并涉及不同研究问题或范围边界的内容。
• 优先将细粒度的区分放入项目符号 / 维度中，而不是创建新子章节。

3. 在 outline/outline.yml 中应用合并：

• 合并标题，使子章节标题更清晰、更充实。
• 合并项目符号（去重模板；保留 Stage A 字段：Intent/RQ/Evidence needs/Expected cites）。
• 尽可能保持 id 稳定。
  • 如果必须更改 id，请在报告中明确记录，并假定需要重新生成 mapping.tsv。

4. 编写 outline/OUTLINE_BUDGET_REPORT.md：

• 合并前 / 后的数量。
• 合并列表（旧 id/标题 -> 新 id/标题）。
• 任何风险（例如，需要重置映射）。

质量检查清单

• 没有占位符（TODO/…/(placeholder)）。
• 大纲预算符合论文式目标。
• 每个保留的 H3 都足够充实，能够支撑以证据为先的写作（其项目符号应提及具体比较、评估依据和失败模式）。

故障排查

问题：合并导致子章节范围过宽

解决方法：

• 保留一个 H3，但将项目符号拆分为明确的比较维度和必需的证据字段；如果后续证据足够充分，再进行更细粒度的拆分。

问题：更改 id 后映射失效

解决方法：

• 重新运行 section-mapper 以重新生成 outline/mapping.tsv，然后重新运行 outline-refiner。