用途
Table Schema 用于调研（survey）写作流程中的表格设计阶段。它的目标是在用 LaTeX 生成表格之前，先定义出可验证、可填充的表格 schema，避免生成无法从已有证据中填满的表格。该技能强调：表格不是装饰，而是压缩；如果某一列无法在不猜测的情况下从现有证据包中填充，那么 schema 就是错的。
两层表格结构
该技能把表格分为两层：
- outline/tables_index.md（内部）：用于覆盖度/调试与快速证据扫描，允许更详尽，但不应插入论文。
- outline/tables_appendix.md（面向读者）：可发布的调研表格，布局干净、信息密度高，可作为附录插入最终 PDF。
该技能在填充之前同时设计这两层。
主要能力
- 为每张表定义其要回答的问题。
- 定义行单位（H3 / benchmark / work / failure mode）。
- 定义列，并约束单元格风格（短词组，避免段落式单元格）。
- 建立证据映射：每一列对应哪些上游字段。
- 按 draft_profile 设定最低表格数量：course_paper 至少 1 张索引表 + 1 张附录表；survey / deep 至少 2 张索引表 + 2 张附录表。
- 提供推荐默认表集（arxiv-survey 家族）：索引表 I1（子章节地图：轴 + 代表性工作）、I2（具体锚点：benchmark / 数字 / 注意事项）；附录表 A1（方法/架构地图）、A2（评估协议 / benchmark 地图）。
使用方式
该技能默认以语义（LLM 优先）方式工作，视为设计任务，而不是运行脚本。工作流使用以下输入：
- GOAL.md：保持读者问题与范围稳定。
- queries.md:draft_profile（若存在）：控制表格预算，但不改变证据标准。
- outline/outline.yml：对齐表格行单位与论文结构。
- outline/subsection_briefs.jsonl：将表格维度/轴建立在已批准结构上。
- outline/evidence_drafts.jsonl：确保每个计划列都可填充而不需猜测。
输出为 outline/table_schema.md。
可选脚本引导（bootstrap）：
uv run python .codex/skills/table-schema/scripts/run.py --help
uv run python .codex/skills/table-schema/scripts/run.py --workspace <workspace>
全部选项：
- --workspace <workspace>（必填）
- --unit-id <id>（可选；仅用于 runner 记账）
- --inputs <outline;briefs;packs;goal>（可选；覆盖输入）
- --outputs <relpath>（可选；默认 outline/table_schema.md）
- --checkpoint <C#>（可选；引导脚本忽略）
示例：
uv run python .codex/skills/table-schema/scripts/run.py --workspace <workspace>
uv run python .codex/skills/table-schema/scripts/run.py --workspace <workspace> --outputs outline/table_schema.md
脚本仅作为起点，之后应把 schema 作为论文产物继续打磨。
角色
- Table Designer（读者视角）：选择能回答读者问题（而非流程问题）的表格；每张表回答一个问题；表格足够小以便填充。避免在论文中出现内部/日志式表格，避免只有本仓库才懂的列标签。
- Evidence Steward（可填充性）：拒绝需要编造事实的 schema；把每一列映射到具体的上游字段；拒绝会迫使写出长段落单元格的列。避免 TODO 列和占位符（"TBD"、"..."、"(placeholder)"）。
适用场景
适用于希望调研表格可验证、可填充，且通常在证据包已存在之后（典型为 Stage C4）进行表格设计的场景。触发词包括：table schema、schema-first tables、table design、表格 schema、先 schema 后填充。
限制
- 若某列无法在不猜测的情况下从证据包填充，则该 schema 不成立。
- 附录表的标题/列必须可发布，不能包含流程术语。
- 内部诊断信息应放入审计报告，而非面向读者的表格。
- 关于收费、价格、平台支持等具体信息，资料中暂未提供。