mcpField
L
llm-wiki

llm-wiki

github.com/godstale生産性649 回インストール25 週間前に更新
リポジトリ

llm-wiki について

llm-wikiは、情報の取り込み、検索、保守、グラフ生成を行うエージェントスキルです。相互リンク付きのWikiページとライフサイクルコマンドで、情報源や検索結果を整理します。

主な機能

  1. 01情報源をWikiページに取り込む
  2. 02リンク付き引用でページを検索
  3. 03検索結果を保存
  4. 04リンク切れや古い要約を検査
  5. 05ナレッジグラフを構築

活用シーン

  1. 01メモや資料の整理
  2. 02Wikiページから情報を検索
  3. 03Wikiのリンクや要約を点検

インストール

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

$npx skills add https://github.com/godstale/llm-wiki --skill llm-wiki

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

同梱ファイル

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

LICENSE
CHANGELOG.md
GEMINI.md
.gitignore
README.md
CLAUDE.md
AGENTS.md
README.ko.md
references/
graph-html.md
folder-managing.md
ingest-advanced.md
ontology-commands.md
query-advanced.md
ontology-template.yaml
ontology-data-template.yaml
templates.md
ontology-interview.md
scripts/
file_to_markdown.py
lint.py
query_filter.py
ontology_validate.py
requirements.txt
build_graph.py
test/ontology_test/
scala.md
test/ontology_test/wiki/
ontology-registry.md
test/ontology_test/wiki/ontologies/
scala.yaml
test/wiki_test/
Test_Result.md
test/wiki_test/raw_test/
AI_개발_학습_자료.json
AI_개인_프로젝트_목표.json
베트남_여행_항공권.json

詳細

LLM Wiki：エージェントの標準作業手順

これは、LLM Wiki プロジェクトの主要な「運用マニュアル」です。ナレッジのライフサイクル、つまり 取り込み → 検索 → リント → グラフ を管理します。

🧭 コアワークフローの一覧

詳細な手順については、各項目に対応するリファレンスファイルを参照してください。

段階アクションリファレンス
取り込み/wiki-ingest [<file>|--from <dir>]references/ingest-advanced.md
検索/wiki-query <question>references/query-advanced.md
保存/wiki-synthesize [slug]SKILL.md#wiki-synthesize
保守/wiki-lint | /wiki-graphSKILL.md#maintenance
編集/wiki-update | /wiki-deleteSKILL.md#lifecycle
オントロジー/wiki-ontology-*references/ontology-commands.md

🏗️ プロジェクト構成

wiki/
  index.md          # Catalog of all pages (Update EVERY ingest)
  log.md            # Chronological record (Append-only)
  history.json      # Ingest registry (Always use Write tool)
  sources/          # Summaries (kebab-case.md)
  entities/         # People/Projects (TitleCase.md)
  concepts/         # Ideas/Theories (TitleCase.md)
  syntheses/        # Saved query answers
  originals/        # Read-only archive
  ontologies/       # (OPTIONAL) Structured YAML data

テンプレートとスキーマ → references/templates.md | Wiki リンク：[[PageName]]（大文字と小文字を区別）

📥 取り込みプロセス

主な目的： 生の入力を構造化された Wiki ページに変換し、元のファイルをアーカイブします。

  1. 分析： ソースを読み込みます。タイトル／スラッグを決定します。
  2. 戦略： モード（完全版または要約のみ）を選択します。
    • 要約のみ： .xlsx、.pptx、30 ページを超える .pdf、または --summary-only フラグ。
  3. 実行：
    • wiki/sources/<slug>.md に書き込みます。
    • 階層的な分類（例：Hobby/Cycling）を使用して wiki/index.md を更新します。ルールとデフォルトについては references/ingest-advanced.md を参照してください。
    • wiki/entities/ と wiki/concepts/ を作成／更新します。
  4. 登録： wiki/history.json を更新し、wiki/log.md に追記します。

詳細フラグ（--to、--precision、--no-interview など） → references/ingest-advanced.md

🔍 検索と統合

/wiki-query
  1. wiki/index.md、wiki/synthesis-map.md、wiki-hub.md から関連ページを見つけます。
  2. sources/、entities/、concepts/、ontologies/ からコンテキストを収集します。ファイルが wiki-hub.md に記載されている場合は、外部ソースのリポジトリを引用します。
  3. [[PageName]] 形式の引用を付けて回答を統合します。 構造フィルター（class:、type:、AND/OR） → references/query-advanced.md
/wiki-synthesize

最後の検索結果を wiki/syntheses/<slug>.md に保存します。

  1. 質問からスラッグを生成します。
  2. wiki/synthesis-map.md（追記のみ）と wiki/log.md を更新します。

🛠️ 保守とライフサイクル

#maintenance
  • /wiki-lint：孤立ページ、リンク切れ、古い要約を確認します。（レポート：wiki/lint-report.md）。wiki-hub.md が存在する場合、インポートされた外部ファイルを参照元とするリンク切れは無視するか、重大度を下げます。
  • /wiki-graph：graph/graph.json と graph/graph.html を再構築します。
#lifecycle
  • /wiki-sources：history.json に記録された取り込み済みソースを一覧表示します。
  • /wiki-update ：元のファイルからソースを更新します。
  • /wiki-delete ：ソースを論理削除します（履歴には残し、ページは削除します）。

🔗 Wiki-Hub アーキテクチャのサポート

プロジェクトのルートに wiki-hub.md ファイルが存在する場合、外部ファイルの信頼できるレジストリとして機能します。

1. 外部ソースの引用
  • /wiki-query の実行中、エージェントは回答に使用するファイルを wiki-hub.md で必ず確認する必要があります。
  • ファイルがインポート済みソースとして記載されている場合、引用には外部リポジトリの情報を含める必要があります（例：[[PageName]] (Source: repo-name)）。
2. リント時の例外
  • /wiki-lint は wiki-hub.md の ## Imported Sources リストを読み込む必要があります。
  • ハブに記載されているファイルのリンク切れ警告は、インポートされていない依存ファイルへのリンクによる不要な通知を避けるため、抑制するか「外部」としてマークします。
3. ファイルの整合性
  • ユーザーの明示的な確認なしに、wiki-hub.md で管理されているファイルを上書き、変更、削除しないでください。これらのファイルはハブを介して外部で管理されています。

⚠️ 注意点と重要なルール

  • 読み取り専用： wiki/originals/ は決して変更しないでください。
  • 一貫性： 検索での発見性を保つため、取り込みのたびに必ず wiki/index.md を更新してください。
  • 履歴： wiki/history.json は必ず読み込み、マージしてから書き戻してください。
  • クリーンアップ： 削除時は、孤立したエンティティ／コンセプトページがないか確認してください。

コメント

Markdown 対応