用途
Table Filler 用于在研究写作流程中填充索引表格，产出文件 outline/tables_index.md。它把已有的表格结构定义与证据包转换为紧凑的、带引用支撑的索引表，服务于后续写作与附录表格整理。
该文件被定位为规划与可追溯性产物：便于调试覆盖范围、快速查看已有证据，但不应原样粘贴进论文。面向读者的表格属于 outline/tables_appendix.md，由 appendix-table-writer 负责整理。
触发与适用条件
触发词包括：table filler、fill tables、evidence-first tables、index tables、表格填充、索引表。
适用场景：表格结构（table schema）已存在，且证据包已就绪；需要一张紧凑、带引用支撑的索引表来支持后续写作与附录表格整理。
默认模式为语义模式（LLM 优先）：把证据包内容以紧凑单元格形式重述，并在行内附带引用，避免堆砌引用的段落。
工作流程
- 先读取 outline/table_schema.md，它定义每张表必须回答什么。
- 若存在 queries.md:draft_profile 则读取（course_paper 需要一张索引表；survey / deep 需要两张）。
- 使用 outline/subsection_briefs.jsonl 与 outline/evidence_drafts.jsonl 填充子章节映射并挑选范围内的引用。
- 使用 outline/anchor_sheet.jsonl 填充锚点事实表（优先量化/评估类锚点）。
- 对照 citations/ref.bib 校验引用键。
输入
- outline/table_schema.md
- outline/subsection_briefs.jsonl
- outline/evidence_drafts.jsonl
- outline/anchor_sheet.jsonl
- citations/ref.bib
输出
- outline/tables_index.md
输出格式约定
outline/tables_index.md 必须：
- 对 course_paper 至少包含 1 张 Markdown 表，对 survey / deep 至少 2 张；
- 每张表前有一行标题，例如 Index Table 1. ...；
- 除非出于内部可读性需要，否则不包含 Markdown 标题（#、##、###）；
- 行内使用 [@BibKey] 形式包含引用；
- 避免占位符（TODO、...、…、脚手架注释）；
- 避免段落式单元格（使用简短短语；谨慎使用 <br>）。
建议填充内容
子章节映射（维度 + 代表性工作）：
- 维度来自 subsection_briefs.axes。
- 代表性工作来自证据包中的引用。
具体锚点（基准 / 数字 / 注意事项）：
- 锚点事实来自 outline/anchor_sheet.jsonl（经整理、带引用支撑）。
- 代表性工作来自锚点表中的引用（或回退到证据包）。
常见失败模式
- 单元格变成长篇散文。修复：压缩为简短短语，把叙述性解释移到正文段落。
- 不靠猜测就无法填满行。修复：视为证据缺口（转交 evidence-selfloop / evidence-draft），或收窄 schema。
脚本（可选引导）
快速开始：
uv run python .codex/skills/table-filler/scripts/run.py --help
uv run python .codex/skills/table-filler/scripts/run.py --workspace <workspace>
全部选项：
- --workspace <workspace>（必填）
- --unit-id <id>（可选；仅用于 runner 记账）
- --inputs <schema;briefs;packs;anchors;bib>（可选；覆盖输入）
- --outputs <relpath>（可选；默认 outline/tables_index.md）
- --checkpoint <C#>（可选；引导脚本会忽略）
示例：
引导索引表（默认输出路径）：
uv run python .codex/skills/table-filler/scripts/run.py --workspace <workspace>
写入自定义索引文件（少见）：
uv run python .codex/skills/table-filler/scripts/run.py --workspace <workspace> --outputs outline/tables_index.md
说明
该脚本是确定性的引导脚本；其结果应视为内部索引产物。面向读者的附录表格需通过 appendix-table-writer 单独整理。