Appendix Table Writer 用于生成可发表的综述附录表格。它的触发词包括附录表格、可发表表格、综述表格、appendix tables、publishable tables、survey tables、reader tables。适用场景是：已有 C4 产物（证据包、锚点表、引用），希望得到看起来像真实综述、而非内部日志的表格。
用途与定位 该技能解决一个具体问题：流水线可以生成便于规划与调试的索引表，但这类表读起来像内部产物。本技能负责撰写可发表、面向读者的表格，可放入附录，特点是排版更干净、信息密度更高、按综述风格组织（方法/基准/风险），而不是呈现中间状态。索引表保留在 outline/tables_index.md 中，不应原样复制进论文。
输入 包括 outline/table_schema.md（表格意图与证据映射）、outline/tables_index.md（内部索引，可选但推荐）、outline/subsection_briefs.jsonl、outline/evidence_drafts.jsonl、outline/anchor_sheet.jsonl、citations/ref.bib，以及可选的 GOAL.md。在需要时读取 references/table_cell_hygiene.md，用于处理附录表格单元格仍复制原始论文自述或通用结果包装的情况；机器可读资产为 assets/table_cell_hygiene.json。
输出 输出为 outline/tables_appendix.md。
角色分工 Survey Table Curator（读者视角）：挑选读者真正希望在综述附录中看到的表格；倾向于用 2 至 3 张表回答大问题（方法、评测、风险），让行之间可比较（同一表格使用相同的行单位），并让表格无需阅读全文即可理解；避免一行对应一个 H3 的索引堆砌，以及使用内部轴名称作为列名（如 axes、blocking_missing、evidence readiness）。 Production Editor（排版）：让表格在 LaTeX 中看起来可发表；列数不超过 4，单元格保持简短（短语而非句子），<br> 谨慎使用（每格 0 至 1 个，绝不堆列表）；避免 6 至 8 列导致文字过小不可读，避免像笔记的单元格（分号链、斜杠列表、长括号说明），避免在标题、表头、单元格中使用斜杠分隔的轴标记（A/B/C），改用逗号或 and，避免读起来像中间产物的内部轴术语（例如把表格列称为 tokens），优先使用 protocol details/metadata/assumptions 等面向读者的表述。 Evidence Steward（可验证性）：防止幻觉；每一行都必须在专门列中带引用（例如 Key refs），只复述证据包/锚点表中出现的内容，证据薄弱时宁可减少行数以保证依据更强；避免列出没有证据包/锚点支撑的 representative works，避免添加上游不存在的基准或方法细节。
表格契约（可发表、附录可用） outline/tables_appendix.md 必须：包含至少 1 个 Markdown 表格（course_paper）或至少 2 个（survey / deep）；每张表前使用标题行，例如 Appendix Table A1. Representative systems by method family and evaluation setting；文件内不得包含标题（#、##、###），因为合并器会添加附录标题；不得包含占位符（TODO、TBD、FIXME、ASCII 三点省略号、Unicode 省略号）；行内引用使用 [@BibKey]，且键必须存在于 citations/ref.bib；避免流水线术语和索引式列名。
工作流程 从 GOAL.md（范围）和 outline/table_schema.md（每张表必须回答什么）开始；存在 queries.md:draft_profile 时读取它，course_paper 默认使用一张强读者表，survey / deep 至少保留两张；把 outline/tables_index.md 作为候选来源，但不要原样粘贴；用 outline/subsection_briefs.jsonl、outline/evidence_drafts.jsonl、outline/anchor_sheet.jsonl 填充行列，不靠猜测；对照 citations/ref.bib 校验每个引用键。
推荐的附录表格（默认集合） 不确定做什么时，可先做两张表。第一张是方法与架构地图（代表性工作）：行单位为工作/系统行（不是 H3 id），示例列包括 Work（短名）、Core idea（一个短短语）、Loop + interface assumptions（一个面向读者的短短语）、Key refs（2 至 4 个引用键）。第二张是评测协议/基准地图：行单位为基准/评测设置（基准稀少时可为规范协议维度），示例列包括 Benchmark / setting、Task + metric（短语而非定义）、Key protocol constraints（预算/成本/延迟/步数/工具访问/威胁模型）、Key refs（2 至 4 个引用键）。可选的第三张是风险/威胁面地图（仅在能保持干净时）：行单位为威胁/失败模式类别，列为 surface、why it matters、mitigation pattern、key refs。
风格示例 反面示例（索引表/内部笔记）：列名为 Axes；单元格为 planning / memory / tools / eval / safety（斜杠堆叠）；每一行 H3 id 带 5 个以上 <br> 行。正面示例（综述表）：列标签面向读者（Core idea、Task + metric、Constraint）；单元格为短短语（不叙事）；读者可快速浏览并比较各行。此外也应避免中间产物痕迹：不要把列标为 token(s)，如需要该概念可改写为 protocol details/metadata/assumptions；避免在单元格中使用 ASCII 箭头如 ->，改用自然措辞（例如 interleaves reasoning traces with tool actions）。
何时停止与上游路由 如果无法在不猜测的情况下填充某一行：删除该行（宁可少而扎实），并向上游路由：加强该领域的 evidence-draft / anchor-sheet。
脚本（生成与校验） 快速开始： uv run python .codex/skills/appendix-table-writer/scripts/run.py --help uv run python .codex/skills/appendix-table-writer/scripts/run.py --workspace <workspace> 全部选项：--workspace <workspace>（必填）；--unit-id <id>（可选，仅用于 runner 记账）；--inputs <a;b;c>（可选，校验器忽略，保留用于 runner 兼容）；--outputs <relpath>（可选，默认 outline/tables_appendix.md）；--checkpoint <C#>（可选，校验器忽略）。 示例：校验默认附录表格文件： uv run python .codex/skills/appendix-table-writer/scripts/run.py --workspace workspaces/e2e-agent-survey-latex-verify-YYYYMMDD-HHMMSS 校验写出到非标准路径的 workspace： uv run python .codex/skills/appendix-table-writer/scripts/run.py --workspace <workspace> --outputs outline/tables_appendix.md 说明：该脚本依据现有证据产物写出 outline/tables_appendix.md，然后校验结果；它始终会把一份简短报告写入 output/TABLES_APPENDIX_REPORT.md。