chapter-briefs

章の概要（H2 執筆カード）［散文なし］

トリガーと振り分け

• トリガー：章の概要、H2 の概要、章の導入計画、セクションの意図、章节意图、章节导读、H2 卡片。
• 使用する状況：outline/outline.yml と outline/subsection_briefs.jsonl が存在し、より厚みのある章（見出しを減らし、論理を深める章）を作りたい場合。

目的：H3 の小見出しを含む各 H2 の章を章単位の執筆カードに変換し、執筆者が次のことをできるようにします。

• 章の導入段落ブロックを追加する（一貫性を保つ）
• 章全体で一貫した比較軸を維持する
• すべての H3 が一から始まる「8 つの小さな島」のような状態を避ける

この成果物は内部向けの意図であり、読者向けの文章ではありません。

執筆品質にとって重要な理由：

• 章の概要は「段落の島」状態を防ぎます。全体を貫く筋道がないと、各 H3 が冒頭からやり直し、書き出しが繰り返されます。
• throughline と lead_paragraph_plan は、コピー可能な文ではなく、判断の制約として扱ってください。

入力

• outline/outline.yml
• outline/subsection_briefs.jsonl
• 任意：GOAL.md

出力

• outline/chapter_briefs.jsonl

出力形式（outline/chapter_briefs.jsonl）

JSONL（H3 の小見出しを含む H2 の章ごとに 1 オブジェクト）。

必須フィールド：

• section_id、section_title
• subsections（アウトライン順の {sub_id,title} のリスト）
• synthesis_mode（次のいずれか：clusters、timeline、tradeoff_matrix、case_study、tension_resolution）
• synthesis_preview（箇条書き 1～2 項目。定型的な「総合すると……」を使わず、H3 をまたいで章をどのように総合するか）
• throughline（箇条書き 3～6 項目）
• key_contrasts（箇条書き 2～6 項目。利用可能な場合は、各 H3 の contrast_hook を反映する）
• lead_paragraph_plan（箇条書き 2～3 項目。計画のみで、文章は書かない）
  • 各項目は章固有の内容とし、具体的な手掛かり（軸／対比のフック／評価の視点）に触れてください。
  • 比較対象を明示しない「段落 1：章を紹介する」のような一般的なつなぎは避けてください。
• bridge_terms（5～12 個の語句。H3 のブリッジ用語を統合したもの）

C5 での使い方（章の導入に関する契約）

執筆者は outline/chapter_briefs.jsonl を使って sections/S<sec_id>_lead.md を作成します（本文のみ。見出しなし）。

契約（論文のような形式で、新たな事実を加えない）：

• 章の比較軸（2～3 個）と H3 同士のつながりを先取りして示します。目次を言い換えてはいけません。
• key_contrasts／bridge_terms をテンプレートではなく手掛かりとして再利用し、章全体の一貫性を保ちつつ、「総合すると」の繰り返しを避けます。
• 根拠を明確にします（C5 の後続部分で引用を 2 件以上含めます。ここで新たな論文を作り出してはいけません）。

ワークフロー

0. （任意）GOAL.md を読み、対象範囲と読者を定めて、その制約を章の throughline に反映します。
1. outline/outline.yml を読み、H3 の小見出しを含む H2 の章を一覧にします。
2. outline/subsection_briefs.jsonl を読み、section_id ごとに概要をまとめます。
3. 各章について、次の項目を作成します。
   • throughline：章全体で比較／説明する内容
   • key contrasts：複数の H3 にまたがる対比を 2～6 項目
   • synthesis_mode：章ごとに総合方法に多様性を持たせる（締めくくりの段落構成が同じものばかりにならないようにする）
   • lead paragraph plan：導入段落で達成すべき目的を 2～3 項目
   • H3 全体で用語を一貫させるための bridge_terms セット
4. outline/chapter_briefs.jsonl を作成します。

品質チェックリスト

• H3 を含む各 H2 の章につき、レコードが 1 つある。
• プレースホルダー（TODO／…／(placeholder)／テンプレートの指示）がない。
• throughline と key_contrasts が章固有である（一般的な内容のコピー＆ペーストではない）。
• lead_paragraph_plan の各項目で、比較軸を 2～3 個と、H3 の小見出しがそれらをどのように分担するかを明示的に先取りしている（一般的な章の導入文句ではない）。

スクリプト

クイックスタート

• uv run python .codex/skills/chapter-briefs/scripts/run.py --help
• uv run python .codex/skills/chapter-briefs/scripts/run.py --workspace <workspace>

すべてのオプション

• --workspace <dir>
• --unit-id <U###>
• --inputs <semicolon-separated>
• --outputs <semicolon-separated>
• --checkpoint <C#>

使用例

• デフォルトの IO：
  • uv run python .codex/skills/chapter-briefs/scripts/run.py --workspace <workspace>
• IO を明示する場合：
  • uv run python .codex/skills/chapter-briefs/scripts/run.py --workspace <workspace> --inputs "outline/outline.yml;outline/subsection_briefs.jsonl;GOAL.md" --outputs "outline/chapter_briefs.jsonl"

改良マーカー（推奨。変更の繰り返しを防止します）

章の概要に納得できたら、次のファイルを作成してください。

• outline/chapter_briefs.refined.ok

これは「確認・改良済み」であることを明示するためのシグナルです。

• スクリプトによる再生成で、作業内容が元に戻るのを防ぎます
• （厳格モードの実行時に）完了シグナルとして使用でき、初期段階のひな形をそのまま受け入れてしまうのを防ぎます

メモ

• このヘルパーは初期設定用です。必要に応じて手動で改良してください。