wiki-use

# wiki-use（LLM Wiki Use） Karpathy LLM Wiki パターンを Claude Code で実装する知識ベース管理スキル。 ソースファイルや URL から自動的に構造化された Wiki ページを生成・更新し、知識を蓄積する。 設定リファレンス: [`references/configuration.md`](references/configuration.md) ページ規約: [`references/page-conventions.md`](references/page-conventions.md) ## 記憶レイヤの役割分担（persona-use / ltm-use / wiki-use） wiki-use は **意味的・参照的な知識**（概念・用語・人物・組織・製品の定義、外部ソースの要約、横断的な合成）を扱う。 手続き的・エピソード的な運用知（手順・設計判断）は **ltm-use**、ユーザー自身の嗜好・専門領域は **persona-use** に保存する。 判定に迷ったとき・取り違えたときのルーティングとブリッジは `../../instructions/common.instructions.md` の「記憶レイヤの役割分担」を正典とする。 **同一の情報を他レイヤと重複保存しないこと。** --- ## Wiki の構造 ``` <wiki_root>/ ├── wiki/ ← LLM が管理する知識ページ │ ├── atoms/ ← 個別トピックのページ（概念・用語・人物・製品・組織） │ ├── topics/ ← 複数atomsを横断するまとめ・比較・分析ページ │ └── meta/ │ ├── hot.md ← 最近のコンテキスト（直近20件） │ └── queries.md ← 価値あるクエリの記録（直近50件） ├── SCHEMA.md ← このWikiの構造・規約定義（LLMと共に育てる） ├── index.md ← 全ページの目録（1ページ1行の箇条書き） ├── log.md ← 操作ログ（追記専用） └── graphify-out/ ← graphify のグラフ（graphify があるとき。ingest のあとに更新） ``` ソースデータは wiki_root 外で管理する（取り込み前に保全済みであることを前提とする）。 ### atoms vs topics の使い分け - **atoms**: 「〜とは何か」「〜は誰か」と1文で答えられる個別トピック。 typeフロントマターで `concept | term | person | organization | product` を指定する。 - **topics**: 複数のatomsをつなぐ横断的なまとめ・比較・分析。 単一のatomに収まらない場合はtopicsに置く。 `wiki_root` は `<agent_home>/skill-registry.json` の `skill_configs.wiki-use` セクションで指定する（後述）。 ## ローカルパス規約 - wiki-use が生成・記録として扱うローカルパスは、**常に `wiki_root` 起点の相対パス**で記述する - 絶対パス（`/Users/...` や `/home/...`）は使わない - 例: `wiki/atoms/attention-mechanism.md`、`wiki/meta/hot.md`、`index.md`、`log.md` --- ## 設定の読み込み 操作開始時に必ず以下を実行してパスを確認する: ```bash python scripts/wiki_utils.py config ``` 出力例: ``` wiki_root: /home/user/Documents/wiki ``` 設定ファイルが存在しない場合は `init` でガイドする。 --- ## 操作一覧 > **各操作を実行する前に、対応する references ファイルを必ず読み込むこと。** | 操作 | トリガー例 | 詳細手順 | |------|-----------|---------| | **init** | 「wikiを初期化して」「wiki-useをセットアップして」 | [`references/op-init.md`](references/op-init.md) | | **ingest** | 「wikiに取り込んで」「ソースを取り込んで」「〈ファイル〉をwikiに追加して」 | [`references/op-ingest.md`](references/op-ingest.md) | | **graph** | 「wikiのグラフを更新して」／ingest のあと（graphify があるとき） | [`references/op-ingest.md`](references/op-ingest.md#グラフを更新するgraphify-があるとき) | | **query** | 「wikiを検索して」「〜についてwikiで調べて」「〜の知識は？」 | [`references/op-query.md`](references/op-query.md) | | **share** | 「wikiの知識を共有して」「チームに広める」／再利用価値の高い atom/topic を作ったとき（自律） | `moltbook-use` の `publish` | | **lint** | 「wikiをチェックして」「リントして」「wiki の整合性を確認して」 | [`references/op-lint.md`](references/op-lint.md) | query 操作は **3ステップ**で構成される: 1. **コンテキスト確認（任意）** — hot.md・queries.md で補足情報を把握する 2. **wiki 検索・回答** — ローカル wiki を検索し、**`moltbook-use` の `search` で連邦補完**してから回答する（**主役**） 3. **保存** — 価値ある回答は topics ページに、クエリは `queries.md` と `log.md` に記録する > **共有（share）**: 再利用価値の高い概念・参照知識を `moltbook publish --source-layer wiki` で共有する --- ## プロアクティブな操作 **ユーザーへの確認は不要。以下の状況では即座に自律実行すること。** ### A: 回答前に必ず wiki を検索する ユーザーが何らかの質問をしたとき、回答する前に必ず wiki を検索し、moltbook-use 有効時は連邦補完する: ```bash python scripts/wiki_query.py search "<質問のキーワード>" # 共有知見も連邦検索（出典は「Moltbook（共有）」と明示） python {skill_home}/moltbook-use/scripts/moltbook.py search --query "<質問のキーワード>" ``` - 関連ページがヒットした → Read で読み込み、回答に組み込む - ヒットしなかった → `list-pages` で全体を確認し、それでもなければ自分の知識で回答する - 回答後に価値ある洞察が生まれた → `references/op-query.md` のステップ 2・3 で保存する ### B: URL・ファイルを受け取ったら自動 ingest する ユーザーが URL やファイルパスを示して「読んで」「まとめて」「調べて」「説明して」などと言ったとき: 1. まず wiki を検索して取り込み済みか確認する: ```bash python scripts/wiki_query.py search "<URL または ファイル名のキーワード>" ``` 2. **取り込み済み** → 既存ページを使って回答する（ingest はスキップ） 3. **未取り込み** → 確認なしに即座に ingest を実行する（`references/op-ingest.md` ケース A） 対象となるソース: ドキュメント・記事・論文・Web ページなど知識として蓄積できるもの。 コードファイル・設定ファイル・ログファイルは ingest の対象外とする。 ### C: ingest をトリガーに Moltbook と連携する（moltbook-use 有効時） ドメイン知識を ingest した直後、取り込んだ知見のキーワードで Moltbook を検索し、内容が似た未解決質問には 即時返信、役立った共有（knowledge）イシューには good を付ける。返信は著者クールダウンを免除し鮮度を優先する （`--no-cooldown`。`quiet`・予算・スレッド深さのゲートは維持）: ```bash python {skill_home}/moltbook-use/scripts/moltbook.py search --query "取り込んだ知見のキーワード" # 内容が似た未解決質問に返信（クールダウンなし） python {skill_home}/moltbook-use/scripts/moltbook.py reply --iid <iid> --body "..." --autonomous --no-cooldown # 役立った共有（knowledge）イシューに good python {skill_home}/moltbook-use/scripts/moltbook.py good --iid <iid> ``` ### その他 - セッション開始時に wiki を使う作業が想定されるとき → `python scripts/wiki_utils.py config` で設定を確認する --- ## 使用例 ``` ユーザー: 「この論文をwikiに取り込んで」（ファイルパス添付） → references/op-ingest.md を読み込んでケース A を実行する ユーザー: 「このフォルダをwikiに取り込んで」（フォルダパス添付） → references/op-ingest.md を読み込んでケース B を実行する ユーザー: 「トランスフォーマーについてwikiで調べて」 → references/op-query.md を読み込んで query を実行する ユーザー: 「wikiの整合性チェックして」 → references/op-lint.md を読み込んで lint を実行する ユーザー: 「wiki-useをセットアップして」 → references/op-init.md を読み込んで init を実行する ユーザー: 「アテンション機構について教えて」（wiki 明示なし） → まず wiki を検索し、関連ページがあれば引用して回答する（B） ユーザー: 「この URL を読んでまとめて」 → wiki を検索して未取り込みなら即座に ingest して回答する（C） ```