mcpField
T
table-filler

table-filler

github.com/willoscar文档处理51741 次安装3 周前更新
代码仓库

关于 table-filler

table-filler 根据表格 schema 和证据材料生成简洁、带引用的索引表，用于内部检查覆盖情况和追溯依据，不作为论文读者版表格。

主要功能

  1. 01根据证据材料填充表格
  2. 02在表格行中添加引用
  3. 03映射小节与代表性研究
  4. 04生成内部索引表

适用场景

  1. 01检查各小节的证据覆盖
  2. 02追溯论点对应的引用文献
  3. 03为附录表格整理准备材料

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill table-filler

安装后在 Claude Code 中输入/table-filler确认已加载。

附带文件scripts/run.py

详细介绍

表格填充器（索引表，证据优先）

触发条件与路由

  • 触发词：表格填充器、填充表格、证据优先表格、索引表、表格填充、索引表。
  • 使用时机：表格架构已存在且证据包已就绪；你希望生成一份精简、有引用支持的索引表，以支持后续写作和附录表格整理。

目标：生成 outline/tables_index.md，作为内部的、有引用支持的索引。

此文件是规划与追溯材料：

  • 有助于调试覆盖情况，并快速了解现有证据
  • 不应原样粘贴到论文中

面向读者的表格应放在 outline/tables_appendix.md 中，并由 appendix-table-writer 整理。

默认模式：语义模式（优先使用大模型）

将此任务视为根据证据包填充表格材料：

  • 将证据包内容简洁地改写到单元格中
  • 在行中附上引用（避免堆砌引用的段落）

工作流（明确输入）

  • 首先阅读 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 张
  • 每张表格前都有标题行，例如 **索引表 1. ...**
  • 不包含 Markdown 标题（#、##、###），除非明确需要这些标题来提升内部可读性
  • 在行中使用 [@BibKey] 添加引用
  • 避免使用占位符（TODO、...、…、脚手架注释）
  • 避免使用段落式单元格（使用短语；谨慎使用 <br>）

填写内容（推荐默认项）

  1. 小节映射（主题轴 + 代表性工作）
  • 主题轴来自 subsection_briefs.axes。
  • 代表性工作来自证据包中的引用。
  1. 具体锚点（基准测试／数字／注意事项）
  • 锚点事实来自 outline/anchor_sheet.jsonl（经整理且有引用支持）。
  • 代表性工作来自锚点表中的引用（若无，则回退至证据包）。

常见失败模式

  • 单元格变成长篇文字

    • 修正：压缩成短语；将叙述性说明移到正文部分。

  • 表格行无法在不猜测的情况下填写

    • 修正：将其视为证据缺口（转交 evidence-selfloop / evidence-draft），或缩小表格架构的范围。

脚本（可选初始化）

快速开始
  • 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>（可选；仅用于运行器记录）
  • --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 整理。

评论

支持 Markdown