用途:在已有 papers/core_set.csv 与 outline/outline.yml 时,为每个 outline 子章节挑选足够且有代表性的支持论文,输出论文到子章节的映射,并跟踪覆盖率,便于后续证据构建与综述写作。触发词包括 section mapper、mapping.tsv、coverage、paper-to-section mapping、论文映射、覆盖率。
主要能力:生成 outline/mapping.tsv、outline/mapping_report.md(复用热点、弱信号子章节诊断)、outline/mapping_gap_candidates.tsv(核心集不足时的只读修复候选)。评分前会移除语料库通用词与 outline 通用词,加权子章节标题对齐,并拒绝缺少足够章节特定证据的候选。可选 assets/domain_packs/*.json 规则约束模糊子章节标签。
使用方式:可用可选脚本,先运行 uv run python .codex/skills/section-mapper/scripts/run.py --help,再运行 uv run python .codex/skills/section-mapper/scripts/run.py --workspace <workspace> --per-subsection 28。支持 --per-subsection、--diversity-penalty、--soft-limit、--hard-limit、--minimum-score 等选项。冻结标记:创建 outline/mapping.refined.ok,且需比 mapping、核心集、outline、查询契约和映射实现更新;上游变更会使其失效,重跑无标记会备份为 outline/mapping.tsv.bak.<timestamp>。
适用场景与限制:适合在 structure 阶段(C2)检查每小节论文覆盖,提前发现弱信号子章节以调整范围或补充论文。默认每小节论文数 A150++ 为 28,小型约 12–20,轻量约 3–6;每小节少于 3 篇需扩检、合并或调整。核心集不足时应视为证据缺口,不要用无关论文填充。在 pipeline.py --strict 下,通用 why 理由可能阻塞映射。具体收费标准暂未提供。