distill-book

書籍を蒸留する

核心となる考え方

書籍は、1 つのコンテキストウィンドウに読み込んでうまく推論するには大きすぎます。そこで、ファンアウトします。書籍を章ごとに分割し、各章をそれぞれ専用のサブエージェントに渡して単独で蒸留させ、その後、生の章ではなく短い概要を読み戻して統合します。

要点は コンテキストの衛生 です。各サブエージェントは 1 章だけを読み込み、オーケストレーターは完全な章を決して読まないため、このアプローチはどんな規模の書籍にも対応できます。もし自分自身のコンテキストに生の章テキストを引き込んでいることに気づいたら、その利点は失われています。委任してください。

このスキルは意図的に高レベルでフォーマット非依存に保たれています。書籍は PDF、EPUB、Markdown、HTML、プレーンテキスト、その他の形式で届くかもしれません。その形式に適したツールと方法を使ってください。重要なのは以下のワークフローであり、細かな仕組みではありません。

このスキルを使う場面

一度に読むには大きすぎる長い文書（書籍、マニュアル、レポート）から核心となる学びを得たいときに使います。とくに、その結果をスキルや構造化された概要にしたい場合に適しています。コンテキストに収まる短い文書であれば、そのまま直接読んでください。この仕組みは過剰です。

ワークフロー

1. ソースが使えるか確認し、取り組む前に問題を指摘する。 その形式が何であれ、文書から本物の抽出可能なテキストを得られることを確認します。形式によっては最初に手順が必要です。スキャンされた PDF には OCR が必要で、HTML はマークアップを除去する必要があるかもしれません。一方、Markdown やプレーンテキストはそのまま使えます。その形式に適したツールを使ってください（たとえば PDF には pdf スキル）。ソースから使えるテキストが得られない場合は、長いプロセスの後ではなく、最初にそう伝えてください。

2. 章（または自然なセクション）に分割する。 書籍自体の構造（目次、見出し）を読んで境界を見つけます。慣習は書籍ごとに大きく異なるため、これは固定されたルールではなく判断です。トークンを使う前に、分割が妥当に見えるか確認してください。明確な章がなければ、部、セクション、または妥当なチャンクにフォールバックし、何をしたかを伝えてください。通常は前付・後付（序文、索引、付録）は、蒸留する価値がある場合を除いて省略します。

3. 各章を並列で蒸留する。 章ごとに 1 つのサブエージェントを model: "opus" で起動します。章ごとの蒸留には最も高価なモデルは必要ありません。判断は統合ステップにあります。すべてを 1 つのバッチで起動し、並行して実行されるようにします。各サブエージェントのプロンプトは自己完結している必要があり、以下を含めるべきです。

   • どの章を読むか、および文脈のための書籍名・章タイトル。
   • 最終目標に合わせたフォーカスレンズ -- これは何よりも重要です。コーディングスキルであれば、エンジニアが実際に適用できる原則と実践（定義、なぜ、具体的な技法、アンチパターン、経験則）を求めてください。平坦な要約ではありません。書評であれば、物語的な要点を求めてください。このレンズが下流のすべてを形作ります。
   • 概要をファイルに書き出し、短いトークンだけを返信する という指示（例:「done ch5」）。ファイルに書き出すことで、読み取ることを選ぶまで概要がオーケストレーターのコンテキストに入りません。
   • 目標とする長さと、「水増ししない」という促し。

4. 統合する。 概要を読み戻します（それらは小さいものですが、すべて合わせると大きくなる可能性があります。ページ単位で読むか、非常に大きな書籍では統合サブエージェントを使います）。その後、成果物を生成します。章の順序ではなくテーマ別に整理された蒸留文書、または再利用可能なガイダンスが目標であれば、skill-creator スキルに引き継いでスキルを作ります。自分の言葉で蒸留してください。通常、書籍を引用する必要はありません。

5. クリーンアップ ユーザーが保持を希望しない限り、中間作業ファイルを削除します。

覚えておくこと

• サブエージェントは独立しており、共有メモリはありません -- すべてのプロンプトは単独で完結します。
• 著作権を尊重してください。これは、ユーザーが正当に入手した書籍を、その人自身のノートやツールに蒸留するためのものであり、丸ごと複製するためのものではありません。