用途
Outline Refiner 是一个“planner pass”单元，定位在写作之前的规划与诊断环节。它的目标不是生成综述正文，而是让大纲变得可审计：在已有 outline/outline.yml 与 outline/mapping.tsv 的基础上，明确检查证据覆盖情况与结构合理性，并输出可复核的报告，供后续写作或其他 planner 步骤参考。
主要能力
- 解析 outline/outline.yml，枚举 H2 章节与 H3 子章节（用于分节规模/预算判断）。
- 读取 outline/mapping.tsv，计算每个 H3 的覆盖率与复用热点（例如是否反复只使用少数论文）。
- 若存在 outline/OUTLINE_BUDGET_REPORT.md，将其作为合并/变更日志，使覆盖率报告能解释结构变化的原因。
- 若存在 papers/paper_notes.jsonl，汇总被映射论文的证据层级（fulltext/abstract/title）。
- 若存在 outline/subsection_briefs.jsonl，计算每个 H3 的轴具体度（泛化轴 vs 具体轴）。
- 可选使用 GOAL.md 标记明显的范围漂移（关键词未体现在大纲中）。
- 输出 outline/coverage_report.md（项目符号 + 小表格；NO PROSE）与追加式 outline/outline_state.jsonl（每次运行记录一条）。
使用方式
该技能通过脚本运行，典型命令如下：
uv run python .codex/skills/outline-refiner/scripts/run.py --help
uv run python .codex/skills/outline-refiner/scripts/run.py --workspace <workspace>
可用选项：
--workspace <dir>：workspace 根目录--unit-id <U###>：单元 id（可选；用于日志）--inputs <semicolon-separated>：覆盖输入（少见；优先使用默认值）--outputs <semicolon-separated>：覆盖输出（少见；优先使用默认值）--checkpoint <C#>：checkpoint id（可选；用于日志）
示例（section-mapper 之后的 planner-pass 诊断）：
uv run python .codex/skills/outline-refiner/scripts/run.py --workspace <workspace>
触发与路由：触发词包括 planner、dynamic outline、outline refinement、coverage report、大纲迭代、覆盖率报告。当已具备 outline/outline.yml + outline/mapping.tsv，并希望在写作前进行一次可验证、不写散文的 planner pass 时使用。
输入与输出
必需输入：
- outline/outline.yml
- outline/mapping.tsv
可选输入（用于尽力诊断；在流水线早期可能缺失）：
- outline/OUTLINE_BUDGET_REPORT.md（若存在：解释近期合并；帮助理解 mapping/coverage 变化）
- papers/paper_notes.jsonl（用于证据层级）
- outline/subsection_briefs.jsonl（用于轴具体度）
- GOAL.md（用于范围漂移提示）
输出：
- outline/coverage_report.md（项目符号 + 小表格；NO PROSE）
- outline/outline_state.jsonl（追加式 JSONL；每次运行一条记录）
冻结策略与排错
冻结策略：若存在 outline/coverage_report.refined.ok，脚本不会覆盖 outline/coverage_report.md。
排错示例：如果报告中缺少证据层级或轴具体度列，通常是因为可选输入缺失（没有 papers/paper_notes.jsonl 和/或 outline/subsection_briefs.jsonl）。解决办法是先运行 paper-notes 和/或 subsection-briefs，再重新运行 outline-refiner。
适用场景与限制
该技能适用于综述类或研究型写作流水线中，对大纲与文献映射进行结构化、可复现的规划诊断，尤其是需要回答“每个小节是否有足够证据”“是否过度复用少数论文”“子章节切分是否仍偏泛化”“结构是否接近论文形态”等问题的场景。它被定义为确定性的 planner 单元，明确不负责撰写综述散文。关于平台支持、收费、价格等信息，资料中暂未提供。