appendix-table-writer

附录表格撰写（可发表的综述表格）

触发条件与路由

• 触发词：附录表格、可发表表格、综述表格、读者表格、附录表格、可发表表格、综述表格。
• 适用场景：你已有 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

角色（明确使用）

综述表格策划者（读者视角）

使命：选出读者真正希望在综述附录中看到的表格。

应做：

• 优先选择 2-3 张能回答重要问题（方法、评估、风险）的表格
• 使各行具有可比性（全表使用相同的行单位）
• 让读者无需通读全文也能看懂表格

避免：

• 每个 H3 对应一行的索引表倾倒
• 使用类似内部维度的列名（“axes”“blocking_missing”“evidence readiness”）

排版编辑（版式）

使命：让表格在 LaTeX 中达到可发表的呈现效果。

应做：

• 列数不超过 4 列
• 单元格内容简短（用短语，而非完整句子）
• 少量使用 <br>（每个单元格 0-1 个；绝不可堆砌列表）

避免：

• 设有 6-8 列且文字小到难以辨认
• 单元格看起来像备注（分号串联、斜杠分隔列表和冗长括号）
• 在标题、表头或单元格中使用斜杠分隔的维度标记（A/B/C）（合并后的措辞检查会标记此类内容）；应改用逗号或“以及”
• 使用打印出来后像中间产物的内部维度术语（例如将表格列称为“tokens”）；优先使用“协议详情/元数据/假设”

证据管理员（可验证性）

使命：防止幻觉。

应做：

• 每一行都必须在专门的列中包含引用（例如“Key refs”）
• 只重述证据包或锚点表中出现的内容
• 证据薄弱时，宁可减少行数，也要确保依据充分

避免：

• 没有证据包或锚点表中相关主张支持的“代表性工作”
• 添加上游材料中未提供的基准或方法详情

表格要求（可发表，适用于附录）

outline/tables_appendix.md 必须：

• course_paper 至少包含 1 个 Markdown 表格；survey / deep 至少包含 2 个
• 每个表格前都必须有标题行，例如 **附录表 A1. 按方法家族和评估设置划分的代表性系统**
• 文件中不得包含标题（#、##、###）（合并流程会添加附录标题）
• 不得包含占位符（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 验证每个引用键。

推荐的附录表格（默认集合）

如果不确定要构建什么，可以从以下两个表格开始：

1. 方法／架构映射表（代表性成果）

• 行单位：成果／系统系列（而非 H3 id）
• 列（示例）：
  • 成果（简称）
  • 核心思路（1 个简短短语）
  • 循环 + 接口假设（1 个简短短语，面向读者）
  • 关键引用（2-4 个引用键）

2. 评估协议／基准映射表

• 行单位：基准／评估设置（或基准较少时，采用规范的协议维度）
• 列（示例）：
  • 基准／设置
  • 任务 + 指标（短语，而非定义）
  • 关键协议约束（预算／成本／延迟／步骤／工具访问权限／威胁模型）
  • 关键引用（2-4 个引用键）

可选的第三个表格（仅当内容清晰时）： 3) 风险／威胁面映射表

• 行单位：威胁／故障模式类别
• 列：攻击面；重要性；缓解模式；关键引用

正面／反面示例（风格）

反面示例（索引表／内部备注）：

• 列：“Axes”
• 单元格：planning / memory / tools / eval / safety（斜杠堆砌）
• 每行对应一个 H3 id，包含 5 行以上的 <br>

正面示例（综述表格）：

• 列名面向读者（“核心思路”“任务 + 指标”“约束”）
• 单元格内容简短（不作叙述）
• 读者可以快速浏览并比较各行

另一种正面做法（避免显露中间产物痕迹）：

• 不要将列标为“token(s)”。如果需要表达这个概念，请改写为“协议详情／元数据／假设”。
• 避免在单元格内使用 ASCII 箭头，如 ->；应使用自然表达（例如，“交替穿插推理轨迹与工具操作”）。

何时停止／向上游反馈

如果无法在不猜测的情况下填写某一行：

• 删除该行（宁可行数更少，也要确保内容可靠），并且
• 向上游反馈：完善该领域的 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

• 验证将附录表格写入非标准路径的工作区：

  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。