second-brain

Second Brain — オンボーディングウィザード

LLM Wiki パターンを使って、新しい Obsidian ナレッジベースをセットアップします。LLM は司書として、ソース資料を読み込み、構造化された相互リンク付きの Wiki にまとめ、時間の経過とともに維持します。

ウィザードの流れ

次の 5 つのステップをユーザーに案内します。質問は一度に 1 つだけしてください。各ステップには適切なデフォルト値があり、ユーザーはそのまま受け入れることも、独自の値を指定することもできます。

Step 1: Vault の名前

次のように尋ねます。

「ナレッジベースにどのような名前を付けますか？ この名前がフォルダー名になります。」 デフォルト：second-brain

ユーザーが指定した名前は何でも受け入れます。これがフォルダー名とエージェント設定のタイトルになります。

Step 2: Vault の場所

次のように尋ねます。

「どこに作成しますか？ パスを指定してください。指定がなければ、デフォルトを使用します。」 デフォルト：~/Documents/

絶対パスと相対パスのどちらも受け入れます。~ はユーザーのホームディレクトリに解決します。最終的な Vault のパスは {location}/{vault-name}/ です。

Step 3: ドメイン／トピック

次のように尋ねます。

「このナレッジベースでは何を扱いますか？ 関連するタグを設定し、Vault の目的を説明するのに役立ちます。」

例：「AI 研究」、「フィンテック系スタートアップの競合情報」、「健康とフィットネスに関する個人情報」

自由記述の回答を受け入れます。これを使って、次の内容を作成します。

• エージェント設定用の 1 行のドメイン説明
• ドメインに特化したタグの候補を 5～8 個

Step 4: エージェント設定

このスキルを実行しているエージェントを自動検出します。明確に伝えます。

「現在 [Agent Name] で実行しているため、この Vault 用に [config file] を生成します。」

続いて、次のように尋ねます。

「設定ファイルを作成したい他の AI エージェントはありますか？ 選択肢：Claude Code、Codex、Cursor、Gemini CLI — またはスキップ。」

自動検出されたエージェントは選択肢から除外します。選択されたすべてのエージェントの設定を生成します。

エージェントの検出ロジック：

• CLAUDE.md の規約が使用されている場合、または Skill ツールが Claude Code のものである場合 → Claude Code
• 環境から Codex が示されている場合 → Codex
• 作業ディレクトリに .cursor/ が存在する場合 → Cursor
• GEMINI.md の規約が使用されている場合 → Gemini CLI
• 判断できない場合は、使用しているエージェントをユーザーに尋ねる

Step 5: オプションの CLI ツール

次のように尋ねます。

「これらのツールを使うと、LLM が Vault で実行できることが広がります。すべて任意ですが、インストールをおすすめします。」

1. summarize — CLI からリンク、ファイル、メディアを要約する
2. qmd — Wiki 用のローカル検索エンジン（Wiki の成長に応じて役立ちます）
3. agent-browser — ウェブ調査のためのブラウザー自動化

「すべてインストールするか、特定のツールを選ぶ（例：「1 と 3」）か、スキップしてください。」

ウィザードの完了後：Vault を作成する

すべての回答を収集したら、次の手順を順番に実行します。

1. ディレクトリ構造を作成する

オンボーディングスクリプトに Vault のフルパスを渡して実行します。

bash <skill-directory>/scripts/onboarding.sh <vault-path>

すべてのディレクトリに加え、初期ファイル wiki/index.md と wiki/log.md が作成されます。

2. エージェント設定ファイルを生成する

選択された各エージェントについて、<skill-directory>/references/agent-configs/ から対応するテンプレートを読み込みます。

エージェント	テンプレート	出力ファイル	出力先
Claude Code	claude-code.md	CLAUDE.md	Vault のルート
Codex	codex.md	AGENTS.md	Vault のルート
Cursor	cursor.md	second-brain.mdc	<vault>/.cursor/rules/
Gemini CLI	gemini.md	GEMINI.md	Vault のルート

各テンプレートで、次のプレースホルダーを置き換えます。

• {{VAULT_NAME}} → Step 1 で指定された Vault 名
• {{DOMAIN_DESCRIPTION}} → Step 3 の回答から作成した 1 行の説明
• {{DOMAIN_TAGS}} → Step 3 のドメインに基づき、関連性の高いタグを 5～8 個、箇条書きで生成
• {{WIKI_SCHEMA}} → <skill-directory>/references/wiki-schema.md を読み込み、## Architecture 以降のすべてを挿入

生成した設定を Vault に書き込みます。

3. wiki/log.md を更新する

次のセットアップ項目を追記します。

## [YYYY-MM-DD] setup | Vault initialized
Created vault "{{VAULT_NAME}}" for {{DOMAIN_DESCRIPTION}}.
Agent configs: {{list of generated config files}}.

4. CLI ツールをインストールする（選択された場合）

Step 5 でユーザーが選択した各ツールについて、インストールコマンドを実行します。

• summarize：npm i -g @steipete/summarize
• qmd：npm i -g @tobilu/qmd
• agent-browser：npm i -g agent-browser && agent-browser install

インストール後、<tool> --version で動作を確認します。それぞれの成功または失敗を報告します。

5. 概要を表示する

ユーザーに次の内容を表示します。

1. 作成されたもの — ディレクトリツリーと設定ファイル
2. 必要な次の手順 — Obsidian Web Clipper ブラウザー拡張機能をインストールします。

   Obsidian Web Clipper をインストールすると、ウェブ記事を保管庫に簡単に保存できます。 https://chromewebstore.google.com/detail/obsidian-web-clipper/cnjifjpddelmedmihgijeibhnjfabmlf

3. 開始方法 — Obsidian で保管庫フォルダーを開き、記事を raw/ にクリップしてから、/second-brain-ingest を実行します。

参照ファイル

これらのファイルはこのスキルに同梱されており、<skill-directory>/references/ から利用できます。

• wiki-schema.md — 正規の Wiki ルール（すべてのエージェント設定の唯一の信頼できる情報源）
• tooling.md — CLI ツールの詳細、インストールコマンド、検証手順
• agent-configs/claude-code.md — CLAUDE.md テンプレート
• agent-configs/codex.md — AGENTS.md テンプレート
• agent-configs/cursor.md — Cursor ルールのテンプレート
• agent-configs/gemini.md — GEMINI.md テンプレート

次のステップ

セットアップが完了した後のユーザーのワークフローは次のとおりです。

1. Obsidian Web Clipper を使って、記事を raw/ にクリップします
2. /second-brain-ingest でソースを取り込みます — raw ファイルを Wiki ページに変換します
3. /second-brain-query で質問します — Wiki を検索して、情報を統合します
4. /second-brain-lint で健全性を確認します — 取り込みを 10 回行うごと、または毎月実行します