table-filler

テーブル作成（索引テーブル、エビデンス優先）

トリガーとルーティング

• トリガー：テーブル作成、テーブルの入力、エビデンス優先のテーブル、索引テーブル、表格填充、索引表。
• 使用する場面：テーブルのスキーマがあり、エビデンスパックの準備ができている場合。後の執筆や付録テーブルの編集に役立つ、引用付きの簡潔な索引テーブルを作成したいときに使用します。

目標は、内部用の引用付き索引として outline/tables_index.md を作成することです。

このファイルは計画／追跡用の成果物です。

• 網羅性のデバッグや、どのようなエビデンスがあるかをすばやく把握するのに役立ちます
• 論文にそのまま貼り付けてはいけません

読者向けのテーブルは outline/tables_appendix.md に配置し、appendix-table-writer で編集します。

デフォルトモード：セマンティック（LLM 優先）

エビデンスパックからテーブル成果物を作成します。

• エビデンスパックの内容を簡潔なセルにまとめ直します
• 行内に引用を付けます（引用だけの段落は避けてください）

ワークフロー（明示的な入力）

• まず outline/table_schema.md を読みます（各テーブルで答えるべき内容を定義しています）。
• queries.md:draft_profile がある場合は読みます（course_paper では索引テーブルが 1 つ必要です。survey／deep では 2 つ必要です）。
• 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 では Markdown テーブルを 1 つ以上、survey／deep では 2 つ以上含める
• 各テーブルの前に、**Index Table 1. ...** のようなキャプション行を置く
• 内部での可読性向上を明示的に意図する場合を除き、Markdown 見出し（#、##、###）を含めない
• [@BibKey] を使用して行内に引用を含める
• プレースホルダー（TODO、...、…、ひな形用コメント）を含めない
• 段落のようなセルを避ける（短いフレーズを使用し、<br> は控えめに使う）

作成する内容（推奨されるデフォルト）

1. 小節マップ（軸＋代表的な研究）

• 軸は subsection_briefs.axes から取得します。
• 代表的な研究は、エビデンスパック内の引用から選びます。

2. 具体的なアンカー（ベンチマーク／数値／注意点）

• アンカーファクトは 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 を使って別途編集してください。