nvk/llm-wiki

llm‑wiki – AI エージェント向けの LLM コンパイル済みナレッジベース

概要 – llm‑wiki は、大規模言語モデルエージェント（Claude、OpenAI Codex、OpenCode、Pi など）が個人またはチーム全体のウィキを構築、保守、照会できるオープンソースシステムです。ウィキはアイデア、リサーチ、プロジェクト、成果物を構造化された Obsidian 互換のフォルダレイアウトで保存し、エージェントはソースの自動インジェスト、並列リサーチの実行、コンテンツの監査、審査されたブリーフを成果物プロジェクトに昇格させることができます。

主要概念

• セッション – エージェントごとのオプションのメモリで、ウィキセッションでエージェントが行ったことを記録します。ユーザーごとに無効化できます。
• アダプター – プライベートでマニフェスト駆動のプラグインシステムであり、インジェストおよび書き込み操作を特定のプロバイダー（例：Web、CSV、media‑wiki）にルーティングしながら、認証と副作用を厳格に管理します。
• リサーチモード – ワンショットクエリ、深いマルチエージェントリサーチ、論文駆動の調査、専門家メソッドの選択。
• エクスポートチェックポイント – docs/knowledge/<slug>/ スナップショット。プロジェクトのナレッジの決定論的でプライバシーを最小化した引き継ぎが含まれます。

サポートされているランタイム

ランタイム	呼び出し方法	読み取り専用クエリサイズ	完全なリサーチサイズ
Claude Code (ネイティブ)	/wiki:… コマンドまたは @wiki スキル	wiki:query (≈2.8 KB)	@wiki (≈11.7 KB)
OpenAI Codex (マーケットプレイス)	プラグインインストール後に $wiki-query または @wiki	Claude と同じ	Claude と同じ
OpenCode (指示ファイル)	SKILL.md URL を opencode.json に追加	wiki-query/SKILL.md	wiki-manager/SKILL.md
Pi / DS4 (ローカルモデル)	./scripts/pi-wiki-query (読み取り専用) または pi --skill …/wiki-manager/SKILL.md (完全)
その他の LLM エージェント	profiles/query-lite/SKILL.md (読み取り専用) または AGENTS.md (完全) をコピー

インストールショートカット

• Claude Code – claude plugin install wiki@llm-wiki
• Codex – codex plugin marketplace add nvk/llm-wiki && codex plugin add wiki@llm-wiki
• OpenCode – リモートの SKILL.md URL を opencode.json に追加 (またはローカルに curl)
• Pi – pi --skill path/to/llm-wiki/plugins/llm-wiki-opencode/skills/wiki-manager/SKILL.md

典型的なワークフロー

1. トピックの作成 / 選択 – /wiki:research "nutrition" --new-topic
2. ソースのインジェスト – /wiki:ingest https://example.com/article または ingest‑collection で一括インポート。
3. リサーチの実行 – @wiki research "gut‑brain axis" --deep --min-time 2h (読み取り、要約、相互参照を行う複数のエージェントを生成)。
4. コンパイル済みナレッジの照会 – /wiki:query "How does fiber affect mood?" (読み取り専用) または任意の LLM から wiki-query。
5. ブリーフの昇格 – @wiki audit --project coldcard-threat-model が審査済みのブリーフを配信プロジェクトに移動します。
6. チェックポイントのエクスポート – v0.24.0 は docs/knowledge/ の下に再現可能なスナップショットを書き込むコマンドを追加します。

アーキテクチャのハイライト

• Claude ファーストの信頼できる情報源 – 標準スキルは claude-plugin/skills/wiki-manager/SKILL.md にあります。ランタイム固有のラッパー（Codex、OpenCode、Pi）は同期スクリプトを介して自動的に生成されます。
• プライベートアダプタープロトコル (llm‑wiki‑adapter/v1) – アダプターはインテント、URL ルート、読み取り/書き込み権限を宣言します。プロバイダーの資格情報はウィキに組み込まれることはなく、アダプターが厳密な許可リストと冪等キーを強制します。
• ファイルシステムハブ – ウィキはユーザーが設定可能なディレクトリ（デフォルトは ~/.config/llm-wiki、フォールバックは ~/wiki）にあります。システムは完全に Obsidian 互換であるため、ユーザーは必要に応じて手動でノートを編集できます。
• サンドボックスの使いやすさ – 各ランタイムについて明示的な nono サンドボックスポリシーが文書化されており、エージェントが必要な最小限の読み取り/書き込みアクセス権を持つことを保証します。

重要性

• LLM エージェントに、ステートレスなプロンプトの代わりに、永続的で検索可能なナレッジストアを提供します。
• 再現可能なリサーチパイプラインを実現します：インジェスト → 並列分析 → 監査 → エクスポート。
• 主要な LLM エージェントエコシステム（Claude、Codex、OpenCode、ローカルモデル）にまたがり、単一の信頼できる情報源で機能します。

制限事項 / 注意点

• このシステムは、ホストエージェントがウィキディレクトリを読み取り/書き込みできることを前提としています。サンドボックス環境ではそれらの権限を付与する必要があります。
• 完全なリサーチコマンドは書き込み可能であり、ファイルを変更します。ルックアップのみが必要な場合は、読み取り専用の wiki‑query スキルを使用してください。
• エクスポートされたチェックポイントは読み取り専用です。それらが変更を自動的にコミットまたは公開することはありません。

詳細を学ぶには

• プロジェクトサイト：https://llm‑wiki.net/
• GitHub リポジトリ：https://github.com/nvk/llm-wiki（同期検証については README.md、CHANGELOG.md、および tests/ ディレクトリを参照）
• クイックスタートの例は README の Quick Start セクションにあります。