evidence-draft

エビデンス草稿

トリガーとルーティング

• トリガー: エビデンス草稿、エビデンスパック、主張候補、具体的な比較、エビデンスの抜粋、出典情報、证据草稿, 证据包, 可引用事实.

ブリーフ＋ノート＋任意のエビデンス紐付けから、決定論的な outline/evidence_drafts.jsonl パックを構築します。

互換モードが有効です。この移行では、既存の JSONL 契約を維持しながら、エビデンス品質ポリシー、エビデンスが少ない場合のルーティング、評価アンカーのルールを references/ と assets/ に移します。

読み込み順

必ず読みます：

• references/overview.md
• references/evidence_quality_policy.md

タスクに応じて読みます：

• エビデンスが少ない場合に草稿作成をブロックするか、主張の強さを下げるだけにするかを判断するときは、references/block_vs_downgrade.md
• 評価トークン、プロトコルのコンテキスト、または数値の主張が弱い場合は、references/evaluation_anchor_rules.md
• エビデンスが少ないパックの調整には、references/examples_sparse_evidence.md
• 論文の自己叙述や汎用的な結果の導入文が、パックの抜粋や主張候補に混入している場合は、references/source_text_hygiene.md

機械可読アセット：

• assets/evidence_pack_schema.json
• assets/evidence_policy.json
• assets/source_text_hygiene.json
• リポジトリ全体の assets/limitation-signals.json — 解決済みの失敗や肯定的な改善が制約事項の欄に入らないようにする、共通の極性ルール

入力

必須：

• outline/subsection_briefs.jsonl
• papers/paper_notes.jsonl
• citations/ref.bib

任意ですが推奨：

• papers/evidence_bank.jsonl
• outline/evidence_bindings.jsonl

出力

現在の出力契約を維持します：

• outline/evidence_drafts.jsonl
• 任意の人間が読めるミラーを outline/evidence_drafts/ 以下に出力

スクリプトの境界

scripts/run.py は次の用途に限って使用します：

• ブリーフ／ノート／エビデンスバンク／紐付けの間の決定論的な結合
• 抜粋の抽出と出典情報の組み立て
• ポリシーに基づく blocking_missing／downgrade_signals／verify_fields の具体化
• パックの検証と Markdown ミラーの生成

次の用途に run.py を使わないでください：

• エビデンスが少ない状態を完全に見せるための埋め草の箇条書き
• references/／assets/ から確認できない、隠れたエビデンス不足の判断
• 読者向けの説明文

出力形式のルール

次の項目を維持します：

• 下流のサーベイパイプラインですでに使用されている、既存のトップレベルのパックフィールドを保持する
• claim_candidates は引き続き抜粋から導出する
• concrete_comparisons は引き続き実質的な両面比較にする。一方のクラスタに使用可能なハイライトがない場合は、カードを削除し、A 対 B の対比を捏造するのではなく、上流でエビデンス不足を明示する
• 抜粋のサンプリングではクラスタを考慮する。サブセクションに明示的なクラスタがある場合、アブストラクトに目立つ結果文が含まれているという理由だけで、エビデンスの選定が一方のルートに偏らないようにする
• エビデンス不足は、埋め草の箇条書きではなく、明示的なブロッカー／ダウングレードシグナル／確認フィールドとして示す
• 引用キーは citations/ref.bib に含まれるものに限定する

互換性に関する注意

現在のモードは、参照情報を優先する決定論的な互換モードです：

• assets/evidence_policy.json は、パックのしきい値とエビデンス不足時のルーティングを定義します
• assets/evidence_pack_schema.json は、安定したパック形式を文書化して検証します
• assets/source_text_hygiene.json は、このスキルの導入文のクリーンアップを担い、リポジトリ全体の assets/limitation-signals.json は paper-notes、evidence-draft、writer-context-pack にまたがる制約事項の極性を担います
• scripts/run.py は引き続き既存の JSONL と Markdown の出力を生成しますが、エビデンスが少ないセクションに汎用的な注意書きを追加して水増しすることはなくなりました

クイックスタート

• uv run python .codex/skills/evidence-draft/scripts/run.py --workspace <workspace>

実行時の注意事項

互換モードで実行する場合、scripts/run.py は現在、以下を読み込みます：

• outline/subsection_briefs.jsonl
• papers/paper_notes.jsonl
• citations/ref.bib
• オプションで papers/evidence_bank.jsonl と outline/evidence_bindings.jsonl
• assets/evidence_policy.json と assets/evidence_pack_schema.json

スクリプト

クイックスタート

• uv run python .codex/skills/evidence-draft/scripts/run.py --workspace <workspace>

すべてのオプション

• --workspace <dir>
• --unit-id <id>
• --inputs <path1;path2>
• --outputs <path1;path2>
• --checkpoint <C*>

使用例

• uv run python .codex/skills/evidence-draft/scripts/run.py --workspace <workspace>

トラブルシューティング

• 根拠が乏しいにもかかわらずパックが完全に見える場合は、Python を変更する前に assets/evidence_policy.json と references/block_vs_downgrade.md を確認してください。
• 評価の箇条書きが一般的な内容になっている場合は、references/evaluation_anchor_rules.md とポリシーアセットを確認してください。
• 主張が強い一方で、根拠が抽象的またはタイトルのみの場合は、説明上の注意書きを追加するのではなく、downgrade_signals と verify_fields を使って格下げしてください。