mcpField
W
wiki-builder

wiki-builder

github.com/rohitg00生産性2.9k140 回インストール4 週間前に更新
リポジトリ

wiki-builder について

wiki-builderは、MarkdownファイルとSQLite FTS5インデックスを使って、トピックごとのWikiを作成します。研究、プロジェクト、コードベースなどの資料を整理するユーザーやエージェント向けで、Wikiの種類や出典管理を設定できます。

主な機能

  1. 01Wikiの作成と登録
  2. 02MarkdownページとSQLite FTS5インデックス
  3. 03複数のWikiタイプ
  4. 04グローバルまたはプロジェクト単位の範囲
  5. 05出典引用とメンテナンスログ

活用シーン

  1. 01トピック別の研究Wikiを作成
  2. 02メモや出典資料を整理
  3. 03プロジェクトやコードベースの参照Wikiを管理

インストール

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

$npx skills add https://github.com/rohitg00/pro-workflow --skill wiki-builder

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

同梱ファイル

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

agents/
openai.yaml
references/
wiki-flavors.md
scripts/
init_wiki.sh
wiki-cli.js
templates/
index.md
maintenance-log.md
sources.md
wiki.config.md
templates/prompts/
compile-concept-page.md
compile-index.md
compile-source-page.md
lint-wiki.md
query-and-file.md

詳細

Wiki Builder

あらゆるトピックに対応する、永続的なナレッジベースです。Markdown をディスクに保存し、SQLite FTS5 のシャドーインデックスを使用します。

使用する場面

  • 「 の Wiki を始める」
  • 「この論文／リンク／メモを Wiki に追加する」
  • 「 で X の概念ページをまとめる」
  • 「 Wiki には Y について何と書かれていますか？」（wiki-query に委任）
  • 「自分の Wiki を一覧表示する」

保存場所

  • グローバル：~/.pro-workflow/wikis/<slug>/ — デフォルト。コミットされません
  • プロジェクト：<project>/.claude/wikis/<slug>/ — --scope project を渡すと、コミット可能になります

どちらも同じ ~/.pro-workflow/data.db に登録されます。

種別

種別用途
research継続的なトピックの調査
paper1 本の論文の詳細な調査
domain幅広い分野
product製品／ツールのナレッジベース
person研究者／創設者の詳細情報
organization企業／研究所のプロフィール
project内部プロジェクトのナレッジベース
codebaseリポジトリに紐づく、シンボル／ファイル対応のナレッジベース
incident事後検証のナレッジベース

構成

<slug>/
├── wiki.config.md         # purpose, audience, page types, style, auto_research block
├── raw/                   # untouched source material (PDFs, scrapes, transcripts)
├── wiki/
│   └── index.md           # entry point, hand-curated TOC
├── derived/               # generated artifacts (surveys, charts, summaries)
├── prompts/               # per-task prompts (compile-page, lint, query)
├── logs/maintenance-log.md
└── sources.md             # one row per source: id | url | title | hash | fetched_at

種別に応じて、wiki/papers、wiki/concepts、wiki/people、wiki/products、wiki/timelines、wiki/questions フォルダーが追加されます。

CLI の機能

node $SKILL_ROOT/scripts/wiki-cli.js init <slug> --title "X" --flavor research [--scope project] [--root <path>]
node $SKILL_ROOT/scripts/wiki-cli.js list
node $SKILL_ROOT/scripts/wiki-cli.js page <slug> <rel-path> --title "X" [--type concept|paper|person|...] [--from-file path]
node $SKILL_ROOT/scripts/wiki-cli.js reindex <slug>
node $SKILL_ROOT/scripts/wiki-cli.js info <slug>

init は init_wiki.sh を実行して（dair のレイアウトを反映）、Wiki を SQLite に登録します。page は Markdown を書き込み、FTS の行を upsert します。

呼び出されたときのワークフロー

  1. アクションを特定します（init / ingest / compile / list / reindex / info）。
  2. compile の前に、対象 Wiki の wiki.config.md を読み込みます。
  3. wiki/ に追加するすべての主張には、sources.md の行を出典として記載します（1 つの引用につき、出典の行が 1 つ必要です）。
  4. ページを書き込んだ後、wiki-cli.js page を呼び出し、FTS インデックスとの同期を維持します。
  5. 変更ごとに、logs/maintenance-log.md に 1 行のエントリーを追記します。
  6. トップレベルのページを新規作成した場合は、wiki/index.md を更新します。

品質基準

  • 最初のページからすぐに役立つ内容にします。ひな型だけにはしません。
  • 安定したスラッグをファイル名に使用します（2026-05-08-notes.md ではなく tool-use-benchmarks.md）。
  • 生のソースと、まとめた解釈を分けます。
  • 同じ Wiki 内の関連ページを相対リンクで相互にリンクします。
  • 推測には > SPECULATION: ブロックを付けます。
  • 要約を重複させず、代わりに既存のページへリンクします。
  • 生成したページは、将来のエージェントも巡回しやすい構成にします。

プライバシー

設定に private: true が含まれる Wiki は、wiki-research-loop によって Web ソースから取得されません。ローカルの raw/ のみが対象です。

自動調査のオプトイン

Phase 3.3.0 では Builder と Query のみがリリースされます。Loop は 3.3.1 で提供されます。準備として、wiki.config.md に次の内容を含められます。

auto_research:
  enabled: false        # flip in 3.3.1
  max_pages_per_run: 5
  max_depth: 3
  budget_usd: 0.50
  fetchers: [web, arxiv, github]

テンプレート

wiki.config.md、index.md、プロンプトファイルについては、templates/ を参照してください。init_wiki.sh はこれらを新しい Wiki のルートにコピーします。

コメント

Markdown 対応