Community研究&データ分析github.com

AnsirStudio/llm-wiki-distiller

LLM が管理する個人用マークダウンナレッジベース。散らばった素材を構造化・相互リンク・追跡可能な「セカンド・ミー」に蒸留します。スタンドアロンで共有可能な Claude スキルで、クイック、蒸留、レビュー、検索の4つのモードを備えています。

llm-wiki-distiller とは?

LLM Wiki Distiller は、大規模言語モデル (LLM) が個人用のマークダウンナレッジベースを維持・管理するためのスキルです。ユーザーが学んだこと、重要視していること、気づいたこと、保存したもの、よく忘れること、そして将来のモデルに記憶してほしいことを記録します。百科事典的な一般的知識ではなく、ユーザー独自の視点や情報源、ベースモデルの学習データに含まれない新しい情報、そして再利用可能な個人コンテキストに重点を置きます。このスキルは主に Claude Code などの AI エージェント向けに設計されており、ナレッジベースのルートディレクトリをチェックし、ユーザーの意図(クイック操作、蒸留、レビュー、検索)に基づいて適切なモードを選択します。各モードは専用のガイドファイルに従って動作し、並列処理のためのキャプチャ専用モードと統合モードも提供します。wiki ページは「コンパイルされた記憶」として扱われ、原文の情報源パスを保持しつつ、構造化されたフロントマターと相互リンクを持ちます。共有ハードルールとして、絶対日付の使用、事実と推論の区別、新しい情報と既存知識のコンフリクト時の透明性、機械的操作と判断を要する作業の明確な分離などが定義されており、効率的かつ信頼性の高い知識管理を実現します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add AnsirStudio/llm-wiki-distiller

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

LLM Wiki Distiller

コアコンセプト

大規模言語モデル(LLM)向けの個人ナレッジベースを維持する:ユーザーが学んだこと、重視していること、気づいたこと、保存したこと、よく忘れること、そして将来のモデルに記憶してほしいことを記録します。百科事典的な一般的知識を書き写す必要はありません。ユーザー自身の視点、情報源のパス、トレーニングカットオフ後の新しい情報、そして再利用可能な個人コンテキストに重点を置きます。

リポジトリのルートには、4つの固定ディレクトリと3つのルートファイル(index.md / log.md / pending.md)があります:

  1. raw/:生の素材、添付ファイル、未処理の受信箱。
  2. wiki/:LLM が管理する蒸留エントリ。
  3. _staging/:並列バッチ処理用の一時提案ディレクトリ(ディレクトリは常に存在し、内容は一時的——統合後に削除)。
  4. 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つのモードから選択します:

  1. ユーザーが既存のリポジトリをレビュー/メンテナンスしたい場合(例:「レビューして」「矛盾をチェックして」「健全性チェックを実行して」)→ modes/review.md を読み込む。
  2. ユーザーが既存のコンテンツを調べたり質問したり要約したりしたいだけで、新規追加や変更を必要としない場合 → modes/search.md を読み込む。
  3. ユーザーが新規追加、変更、アーカイブ、削除をしたいが、inbox/raw の生素材を処理する必要がない場合 → modes/quick.md を読み込む。
  4. ユーザーが 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、またはサブエージェント戦略は、使用者のプロジェクトが自身で管理します。

関連スキル