claim-evidence-matrix

主張–証拠マトリックス

トリガーと振り分け

• トリガー：主張–証拠マトリックス、証拠マッピング、证据矩阵、主张-证据对齐。
• 使用する場合：文章を書く前に、各小節の検証可能な主張と証拠ソースを明示する必要がある場合（アウトラインと論文メモの準備が完了している）。
• 使用を避ける場合：outline/outline.yml または papers/paper_notes.jsonl がない場合。
• ネットワーク：なし。
• ガードレール：箇条書きのみ（文章は禁止）。各主張には少なくとも 2 つの証拠ソースを示します（または例外を明示します）。

文章を書く前に、サーベイの主張を明確にし、監査可能な状態にします。

これは箇条書きのみ（文章は禁止）にします。後の執筆を容易にし、「テンプレート的な文章」が紛れ込むのを防ぐことが目的です。

入力

• outline/outline.yml
• papers/paper_notes.jsonl
• 任意：outline/mapping.tsv

出力

• outline/claim_evidence_matrix.md

ワークフロー（ヒューリスティック）

使用するファイル：outline/outline.yml、outline/mapping.tsv。

1. 各小節について、次の条件を満たす主張を 1～3 件作成します。
   • 具体的である（メカニズム／前提／実証的知見）
   • 反証可能である（「Y の評価条件下で X はツールのエラーを減らす」であり、「X は重要である」ではない）
2. 各主張について、2 つ以上の証拠ソースを列挙します。
   • 異なる種類の証拠を優先します（手法論文＋評価／ベンチマーク論文、または競合する 2 つのアプローチ）
3. 簡潔にまとめます：主張 → 証拠 →（任意）留保／限界。
4. 証拠が弱い場合や、要旨のみに基づく場合は、その旨を明示します（過剰な主張は避けてください）。
5. papers/paper_notes.jsonl に bibkey がある場合、証拠項目の横に [@BibKey] を記載し、後の文章化／LaTeX 変換を容易にします。

品質チェックリスト

• すべての小節に 1 件以上の主張がある。
• 各主張に 2 つ以上の証拠ソースが記載されている（または例外が明示されている）。
• 主張がテンプレートのコピー＆ペーストになっていない（「…を中心にまとめる…」のような定型文は避ける）。

補助スクリプト（任意）

クイックスタート

• uv run python .codex/skills/claim-evidence-matrix/scripts/run.py --help
• uv run python .codex/skills/claim-evidence-matrix/scripts/run.py --workspace <workspace>

すべてのオプション

• --help を参照してください（この補助ツールは意図的に最小限の機能にしています）

例

• 最初のマトリックスを生成し、その後手動で調整します。
  • 補助ツールを一度実行し、outline/claim_evidence_matrix.md の主張をより明確にして、証拠が要旨のみに基づく場合は留保を追加します。

注記

• 補助ツールは基本的なマトリックス（主張＋証拠）を生成し、プレースホルダー以外の作業を上書きすることはありません。pipeline.py --strict では、プレースホルダーマーカーが残っている場合にのみ処理がブロックされます。

トラブルシューティング

問題：主張が一般的すぎる、またはアウトラインの定型文のように読める

解決方法：

• 各主張を反証可能な記述に整え、証拠が要旨のみに基づく場合は明示的な留保を追加します。

問題：キーがないため [@BibKey] を追加できない

解決方法：

• citation-verifier を実行して citations/ref.bib を生成し、生成されたキーをマトリックスで使用します。