LLM Wiki Distiller
コアコンセプト
大規模言語モデル(LLM)向けの個人ナレッジベースを維持する:ユーザーが学んだこと、重視していること、気づいたこと、保存したこと、よく忘れること、そして将来のモデルに記憶してほしいことを記録します。百科事典的な一般的知識を書き写す必要はありません。ユーザー自身の視点、情報源のパス、トレーニングカットオフ後の新しい情報、そして再利用可能な個人コンテキストに重点を置きます。
リポジトリのルートには、4つの固定ディレクトリと3つのルートファイル(index.md / log.md / pending.md)があります:
raw/:生の素材、添付ファイル、未処理の受信箱。wiki/:LLM が管理する蒸留エントリ。_staging/:並列バッチ処理用の一時提案ディレクトリ(ディレクトリは常に存在し、内容は一時的——統合後に削除)。review/:レビューレポート(review/YYYY-MM/で月ごとにアーカイブ、最新のレポートがレビューカーソルを兼ねる)。
作成、変更、削除、アーカイブ、または実質的なレビューは、必ず index.md と log.md を同期更新してください。
リソースマップ
このファイルはルーティングのみを担当します。モードを判定したら、すぐに対応するモードファイルを読み込んでください。各モードは、次にどの reference/schema を読むべきかを指示します。
modes/quick.md:受信箱を経由しない、素早い追加、変更、アーカイブ、削除。modes/distill.md:raw/inbox/またはその他の raw 素材を処理し、正式に蒸留します。modes/review.md:レビュー、健全性チェック、マージ提案を実施。各ラウンドで日付入りのレポートを生成します。modes/search.md:読み取り専用の検索と要約。書き込みは行いません。modes/integrate.md:並列オーケストレーション時、オーケストレーターが複数の capture-only サブエージェントからの提案を一括してリポジトリに取り込みます(唯一の書き手、直列)。references/raw.md:raw ディレクトリ、ソース分類、添付ファイル、重複素材の処理。references/wiki.md:wiki ページタイプの判定、境界、書き込みルール。schemas/common.md:共通 YAML フィールド、管理用語リスト、日付とステータス。schemas/raw.md:raw マークダウンポインター、ソースメタデータ、添付ファイル参照ルール。schemas/wiki.md:wiki の各ページタイプのフロントマターと本文構造。schemas/root.md:index.md、log.md、pending.mdのフォーマット。schemas/report.md:レビューレポートの場所、フロントマターと本文構造(最新レポートがレビューカーソルを兼ねる)。schemas/proposal.md:並列オーケストレーション時に、capture-only から integrate へ渡す一時的な提案フォーマット。
すべてのリソースを一度に読まないでください。モードの手順に従って段階的に読み進めてください。
ステップ 0:ナレッジベースルートディレクトリの確認
どのモードを使用する前にも、現在の作業ディレクトリがナレッジベースのルートディレクトリであることを確認してください。軽量な冪等チェックのみを行い、他の reference/schema は読み込みません。
現在のディレクトリを既存のナレッジベースと見なすには、少なくとも次の2種類のシグナルに合致する必要があります:
raw/が存在し、その中にinbox/、attachment/、dropzone/、またはその他の raw 分類がある。wiki/が存在し、その中にconcept/、entity/、summary/、scrap/、またはその他の wiki 分類がある。- ルートファイル
index.md、log.md、pending.mdのうち少なくとも2つが存在する。
処理方法:
- 2種類以上のシグナルに合致:モードゲートに進む。
- 0種類のシグナルに合致し、かつ現在のディレクトリが空またはほぼ空:ユーザーに現在のディレクトリでナレッジベースを初期化するか、既存のナレッジベースのパスを提供するか尋ねる。
- 0~1種類のシグナルに合致し、かつ現在のディレクトリが明らかに他のプロジェクトである:処理を停止し、ユーザーにナレッジベースのパスを要求する。現在のプロジェクト内に
raw/やwiki/を作成しないでください。 - ユーザーがリクエストで明確にナレッジベースのパスを指定した場合、そのパスに切り替えてから再度このチェックを実行する。
モードゲート
ユーザーの意図に基づいて、モード名を明示的に要求せずに4つのモードから選択します:
- ユーザーが既存のリポジトリをレビュー/メンテナンスしたい場合(例:「レビューして」「矛盾をチェックして」「健全性チェックを実行して」)→
modes/review.mdを読み込む。 - ユーザーが既存のコンテンツを調べたり質問したり要約したりしたいだけで、新規追加や変更を必要としない場合 →
modes/search.mdを読み込む。 - ユーザーが新規追加、変更、アーカイブ、削除をしたいが、inbox/raw の生素材を処理する必要がない場合 →
modes/quick.mdを読み込む。 - ユーザーが
raw/inbox/、クリップ、長文、チャット、ソーシャルメディア、PDF、ビデオの文字起こし、GitHub プロジェクト、その他の raw 素材を処理したい場合 →modes/distill.mdを読み込む。
モードが確定しない場合は、最初にユーザーが書き込みを求めているかどうかを判断してください。書き込みだがソースがまだ整理されていない場合は蒸留へ。純粋なクエリは検索へ。リポジトリ自体のメンテナンスはレビューへ。
並列オーケストレーション補足:蒸留モードには
capture-onlyバリアントがあります(各サブエージェントは1つのアイテムのみを担当し、自身のサマリー+raw+_staging/<id>.md提案のみを書き、共有ページには触れません)。これはintegrateモード(オーケストレーターが複数の提案を一括してリポジトリに取り込む)と組み合わせて使用します。制約はmodes/distill.mdの「実行モード」セクションに記載されています。いつ並列化するか、どのようにサブエージェントを割り当てるかは、呼び出し元プロジェクトの CLAUDE.md によって決定され、本スキルの範囲外です。
共有ハードルール
- wiki は「コンパイルされた記憶」として扱い、原文のリポジトリとはしません。raw の情報源パスは保持しますが、原文全体を wiki にコピーしないでください。
- YAML の
original_urlには、素早くウェブページ、動画、投稿、論文、プロジェクトページなどの一次ソースを開くための、核心的な外部 URL のみを設定します。許可されるのはhttp://またはhttps://スキームのみです。ローカルの.md、raw/...、wiki/summary/...、添付ファイルパス、絶対/相対ファイルパス、Obsidian 内部リンク、会話内のローカルドキュメントリンクは、決してoriginal_urlに書き込まないでください。外部 URL がない場合は空配列[]を設定します。raw パス、サマリーページ、内部エビデンスの関連性は、本文の## ソースセクションまたはrelatedフィールドに記述します。検索で補足した情報、背景資料、参考資料は、本文末尾の## ソースに記述し、フロントマターには入れないでください。wiki の YAML でsourcesフィールドを使用しないでください。 2025-01-01より前の知識は、ユーザーにとって重要である、稀である、またはユーザーの思考の基盤を構成する場合を除き、軽く記述します。2025-01-01以降の知識は、モデルのトレーニングカットオフ後のギャップを補う可能性があるため、より重要視できますが、それでも「完全」ではなく「有用」であることを基準とします。- 絶対日付を使用します。永続化する事実に「昨日」「今日」「最近」だけを書かず、必ず絶対日付も併記してください。
- 事実、推論、好み、弱いシグナルを区別します。弱いシグナルは安定した事実として直接書き込まないでください。
- 新しいソースが古いページと矛盾する場合、両方の主張、ソース、日付を保持し、矛盾を明示し、黙って上書きしないでください。
- 書き込む前に、重複ページ、類似タイトル、エイリアス、ソース URL、コアセンテンスを検索します。
- デフォルトでは知識を物理的に削除しません。アーカイブ、陳腐化、置き換えの際には履歴を保持します。実際の削除の前には必ず確認してください。
- 機密性、影響力の大きい、医療/法律/財務、アイデンティティ定義に関わる結論については、エビデンスが曖昧な場合、書き込む前にまずユーザーに確認してください。
- 「判断を要する作業」と「機械的な操作」を区別します。判断を要する作業(蒸留の取捨選択、マージの決定、レビュー時のコンテンツの重要性や削除の判断)は、エージェントがセマンティクスを理解して直接完了する必要があります。これをスクリプトに任せて推測させることはできません——これこそがこのスキルの存在価値であり、スクリプトには判断力がありません。機械的な操作(明確なルールに基づくフィルタリング、カウント、名前変更、フォーマット変換、およびリポジトリが大きくなった場合に必要になる可能性のあるローカル検索/インデックス/ベクトルデータベースなどの基盤)には、コマンドラインツールやスクリプトの使用を推奨し、優先的にそうすべきです。
- 機械的な操作を実行する際は、ファイルの内容全体をエージェントのコンテキストに読み込む必要のない方法(grep/sed/awk/ワンタイムスクリプト、ブラインド実行)を優先し、カウントと diff で結果を検証します(
wc -l、grep -c、git diff --stat)。ファイル全体を読んだり全文をプリントアウトして確認したりしないでください——トークンを節約でき、結果の信頼性は同じです。操作自体に判断が必要な場合(レビュー時にコンテンツの削除を決定するなど)にのみ、先に読んでから実行してください。 - エージェントのオーケストレーションファイルは含めません。異なるプラットフォームの
AGENTS.md、CLAUDE.md、またはサブエージェント戦略は、使用者のプロジェクトが自身で管理します。