chapter-lead-writer

章のリードライター

トリガーとルーティング

• トリガー：chapter lead writer、section lead writer、H2 lead、lead paragraph、章节导读、章节导语。
• 使用する場面：複数のH3小節を含むH2章があり、草稿が小節ごとに独立した段落の寄せ集めのようになっている場合。

目的

このスキルは、H2見出しの下に置く本文のみのリードブロックを作成し、複数のH3小節を含む章がひとつの論旨として読めるようにします。

このSKILL.mdは現在、完全な手法マニュアルではなく、パッケージのルーターです。

移行状況

このパッケージは現在、P0の互換性を維持する移行中です。

• references/とassets/には、意図されたナレッジ層とコントラクト層が配置されています。
• scripts/run.pyは、現在も生成において互換性モードで動作します。
• 今後のスクリプト簡素化では、より多くの判断基準や例をPythonから移し、スクリプトには決定論的な実行と検証のみを残す必要があります。

現時点では、既存の出力コントラクトを維持し、scripts/run.pyを実行時の信頼できる情報源として扱ってください。

入力

必須：

• outline/outline.yml
• outline/chapter_briefs.jsonl
• citations/ref.bib

任意：

• outline/writer_context_packs.jsonl

出力

H3小節を含む各H2セクションについて：

• sections/S<sec_id>_lead.md

出力コントラクト

次のファイル形式のルールを維持してください。

• 各リードファイルは本文のみで、見出しを含みません。
• 各リードファイルは章の視点を予告し、複数のH3をひとつの論旨としてつなぎます。
• 各リードファイルは、章に既存の引用範囲内にとどまります。
• 各リードファイルは、章の後半で裏付けられない新たな事実を追加しません。

読み込み順

必ず次を読みます。

• references/overview.md
• references/lead_block_archetypes.md

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

• references/throughline_patterns.md — 章の概要が簡素すぎる場合や、論旨の流れにまとめにくい場合
• references/bridge_examples.md — スライドのような説明を避けながら、リードでH3間のつながりを強める必要がある場合
• references/bad_narration_examples.md — 目次の読み上げ、計画についての説明、数に基づく書き出しを取り除く場合

機械可読アセット：

• assets/lead_block_contract.json — リードブロックの形式に関する安定したパッケージコントラクト
• assets/lead_block_compatibility_defaults.json — 代替表現、項目数の上限、つなぎ表現、文のリズムに関するデフォルト

ルーティングルール

このスキルは、次の順序で使用します。

1. 章が対象となることを確認する

• outline/outline.ymlからH3小節を含むH2セクションを特定します。
• outline/chapter_briefs.jsonlから対応する章の概要を探します。

2. 手法を読み込む

• references/overview.mdを読みます。
• references/lead_block_archetypes.mdを読みます。
• 章の概要または現在の文章で必要な場合に限り、ほかの参照ファイルを読み込みます。

3. 引用範囲を確認する

• outline/writer_context_packs.jsonlが存在する場合は、章を横断する引用に使用します。
• 引用は既存の章の範囲内にとどめ、キーをcitations/ref.bibと照合して検証します。

4. 実行する

• 現在のフェーズ：現行の動作と出力形式を維持するため、scripts/run.pyを互換性モードで使用します。
• 今後のフェーズ：scripts/run.pyは決定論的な実行のみを担うようにし、執筆手法とアンチパターンの一覧はreferences/に置きます。

互換性モードに関する注意

scripts/run.pyには、現在も有効なリード生成ロジックが含まれています。

これは一時的なものです。現時点では次のようにしてください。

• 現在のスクリプトの文言を、目標とするアーキテクチャとして扱わないでください。
• assets/lead_block_compatibility_defaults.jsonを、互換性モードにおける主要な表現の情報源として扱ってください。
• 大量の文章による指示をSKILL.mdに戻さないでください。
• 有効な処理経路における明らかな説明口調を減らしつつ、現在の出力コントラクトを維持してください。

このスキルで保証すること

詳細な手法がどこにあるかにかかわらず、このスキルは次の条件を満たす章の導入文を生成します。

• 構成を説明するのではなく、その章で比較する視点を明示する
• H3 の各節を、個別の見学箇所ではなく、一つの論旨としてつなげる
• スラッシュ区切りの専門用語を使わず、繰り返し登場する対比を導入する
• 評価や調整の視点を高いレベルで明確に保つ
• スライドの読み上げ、プランナーについての説明、使い回しの導入文を避ける
• 可能な場合は、複数の導入文の枠組み（視点優先／順序優先／比較優先）から選び、同じ定型のリズムをどこでも使い回すのではなく、最も説明口調にならない案を選ぶ

ブロック条件

以下のいずれかに該当する場合は、作業を中止して上流工程に回してください。

• outline/chapter_briefs.jsonl が存在しない
• 対象の H2 セクションに H3 の節がない
• 章の概要が不完全すぎて、論旨の流れを安全に推測できない
• 要求された導入文に、新しい事実や対象範囲外の引用が必要になる

スクリプトの役割

scripts/run.py は、現時点では互換性維持用の実行スクリプトとして扱ってください。

スクリプトを簡素化した後の長期的な役割は、次のものに限定されます。

• 章の特定
• 概要の読み込みと正規化
• 契約の検証
• 決定的なレポートの書き込み

導入文の類型、つなぎの例、説明口調を避けるためのアンチパターンを置く場所として、長期的に使うものではありません。

スクリプト

クイックスタート

• uv run python .codex/skills/chapter-lead-writer/scripts/run.py --workspace <workspace>

すべてのオプション

• --workspace <dir>
• --unit-id <id>
• --inputs <a;b;...>
• --outputs <a;b;...>
• --checkpoint <C*>

例

• uv run python .codex/skills/chapter-lead-writer/scripts/run.py --workspace <workspace>

トラブルシューティング

• outline/chapter_briefs.jsonl が存在しない、または内容が不十分な場合は、まず章の概要を再構築してください。
• outline/writer_context_packs.jsonl が存在しない場合でもスクリプトは実行されますが、引用候補は少なくなります。
• 生成された導入文が説明口調に聞こえる場合は、Python を変更する前に、互換性維持用のアセットと参照先を修正してください。