mcpField
L
llm-wiki-bootstrap

llm-wiki-bootstrap

github.com/nanzhipro生産性284 回インストール
リポジトリ

llm-wiki-bootstrap について

llm-wiki-bootstrapは、個人用LLM Wikiの作成と保守を支援するスキルです。資料を長期的な知識として整理したい人向けで、raw/を読み取り専用の証拠として扱い、SCHEMA.mdを運用規約にします。

主な機能

  1. 01Wiki構造と初期ファイルの作成
  2. 02資料を派生Wikiページに取り込み
  3. 03Wiki内容の検索と引用
  4. 04Wikiの状態と整合性の確認
  5. 05任意のBM25検索設定

活用シーン

  1. 01個人用Wikiをゼロから作成
  2. 02資料を保守対象のページに整理
  3. 03引用付きWikiページで質問に回答
  4. 04Wikiの整合性確認と修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nanzhipro/karpathy-llm-wiki-bootstrap-skill --skill llm-wiki-bootstrap

インストール後、Claude Code で/llm-wiki-bootstrapを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/config/
extend-schema.md
references/templates/
agent-pointer.md
bm25-readme.md
concept-table.md
domain-page-types.md
extend.md
gitignore.md
index.md
log.md
overview.md
schema.md
wiki_fts.py
references/workflows/
bm25.md
bootstrap.md
ingest.md
lint.md
query.md

詳細

LLM Wiki のブートストラップ

個人用の LLM Wiki を構築・維持します。生のエビデンスは raw/ に変更せず保持し、長期的に活用できる知識は wiki/ にまとめます。また、SCHEMA.md を生成された Wiki の唯一の運用規約とします。

このファイルは意図的に短くしています。ユーザーが依頼した操作に必要な詳細なリファレンスだけを読み込んでください。

運用モデル

  • 生成するすべての Wiki で、SCHEMA.md を唯一の信頼できる情報源として維持してください。
  • wiki/concept-table.md を管理対象の概念マップとして維持してください。wiki/index.md を補完し、長期的に活用できる概念、関係、ソース、ステータス、メンテナンスに関するメモをまとめます。
  • CLAUDE.md、AGENTS.md、.github/copilot-instructions.md は、SCHEMA.md への簡潔な案内として維持してください。運用ルールをこれらに重複して記載しないでください。
  • raw/ は読み取り専用のエビデンスとして扱ってください。派生知識の作成・更新は wiki/ 内でのみ行ってください。
  • ブートストラップ、取り込み、クエリ、リント、BM25 の作業に先立ち、EXTEND.md の設定を適用してください。
  • 不足している判断事項のみを質問し、可能であればセットアップに関する質問をまとめて一度にユーザーへ尋ねてください。
  • 段階的な情報開示を優先してください。現在のタスクを完了できる最小限のリファレンスファイルを読んでください。

インテントルーター

ユーザーの意図実施内容リファレンス
新しい Wiki を作成またはブートストラップする設定の事前確認を行い、セットアップの回答を集めてから、ひな型と初期ファイルを生成します。references/workflows/bootstrap.md
1 つ以上のソースを取り込む設定の事前確認を行い、任意の BM25 ゲートを確認してから、ソースの知識を wiki/ にまとめます。references/workflows/ingest.md
Wiki を使ってドメインに関する質問に回答する設定の事前確認を行い、wiki/index.md をたどります。BM25 は候補の検索にのみ使用し、Wiki のページを引用します。references/workflows/query.md
Wiki の健全性または一貫性を確認する構造と内容をスキャンして所見を報告し、承認された項目のみ修正します。references/workflows/lint.md
BM25 検索を設定または使用する設定を読み込み、初期化前に確認を求め、ローカル検索ファイルを作成して、スモークテストを実施し、結果を記録します。references/workflows/bm25.md
設定を構成するスキーマとテンプレートを使って EXTEND.md を探すか、作成します。references/config/extend-schema.md、references/templates/extend.md

設定の事前確認

ブートストラップ、取り込み、クエリ、リント、BM25 の作業に先立ち、references/config/extend-schema.md を読み、そこに記載された検索順で最初に見つかった EXTEND.md を使用してください。見つからない場合は、初回の設定を行い、references/templates/extend.md からファイルを作成してから続行してください。

セッションで初めて使用する際は、どの設定ファイルが有効かを簡潔に伝えてください。デフォルト設定を黙って使用しないでください。

参照ファイルの読み込みルール

  • ブートストラップでは、references/workflows/bootstrap.mdを読み込み、そのファイルを作成するときにのみ各テンプレートを読み込みます。
  • 取り込み、クエリ、リントでは、まず対応するワークフローファイルを読み込みます。検索動作に関する設定やユーザーのリクエストがある場合にのみ、references/workflows/bm25.mdを読み込みます。
  • スキーマ生成では、references/templates/schema.mdを読み込み、必要に応じてreferences/templates/domain-page-types.mdからドメイン別のスニペットを挿入します。
  • ポインターファイルでは、references/templates/agent-pointer.mdを読み込み、生成するファイルは最小限にします。
  • BM25の初期化では、ユーザーが初期化を承認した後にのみ、references/templates/wiki_fts.pyとreferences/templates/bm25-readme.mdを読み込みます。

パッケージレイアウトのルール

  • スキルに属する実行可能なヘルパーのうち、インストール済みのスキルパッケージから実行するものは、scripts/に配置します。
  • 生成出力用のテンプレートは、生成ファイルがユーザーのWikiにコピーされた後に実行可能になる場合でも、references/templates/に配置します。
  • 長い手順のドキュメントはreferences/workflows/に、設定スキーマはreferences/config/に配置します。
  • このスキルでは、references/templates/wiki_fts.pyは生成されるWikiのscripts/wiki_fts.py用のテンプレートであり、スキルからその場で実行するものではありません。

絶対遵守事項

  • ユーザーの明示的な承認なしに、既存のWikiを上書きしてはいけません。
  • ブートストラップ中に.gitkeepなどの空のスキャフォールド用プレースホルダーを作成する場合を除き、raw/内のファイルを変更してはいけません。
  • BM25のスニペットから直接回答してはいけません。まず、返されたWikiページを開いて読み込んでください。
  • ユーザーが別のWiki言語を指定しない限り、取り込み時にはソースの言語を維持します。
  • Wikiの内容を変更するたびに、wiki/index.mdを更新し、wiki/log.mdに追記します。
  • 検索インデックスの再構築に失敗した場合は、Wikiの編集内容を保持して失敗を記録し、wiki/index.mdとテキスト検索に切り替えます。

主な出力

ブートストラップが正常に完了すると、次の内容を含むWikiルートが作成されます。

raw/
wiki/index.md
wiki/concept-table.md
wiki/log.md
wiki/overview.md
SCHEMA.md
.gitignore

オプションの出力は、セットアップの回答や設定によって異なります。実行環境用のポインターファイル、.vscode/settings.json、scripts/wiki_fts.py、indexes/、exports/などがあります。

コメント

Markdown 対応