obsidian-second-brain

obsidian-second-brain

obsidian-second-brain のルーティング優先の入り口です。 Karpathy の LLM-Wiki パターンを進化させ、 自らを書き換える保管庫を実現します。LLM-Wiki アプリが新しいページを追加するのに対し、このスキルは既存のページを書き換えます。人物情報を更新し、主張を改訂し、古くなった事実を置き換え、矛盾を自動的に調整し、複数の情報源にまたがるパターンを自動で統合します。あなたが眠っている間にも進みます。

キーワード：obsidian second brain · self-rewriting vault · obsidian-save · obsidian-ingest

1 つのコードベース、4 つの CLI（Claude Code · Codex CLI · Gemini CLI · OpenCode）、同じブレイン。

このスキルを使う場面

• 静的な書類棚ではなく、自らを維持する Obsidian 保管庫を使いたい場合。
• 作業を保管庫に取り込みたい場合：会話を保存する、URL／PDF／音声／スクリーンショットを取り込む、セッションを記録する、デイリーノートを作成する、タスク／人物／決定事項を追跡する。
• 保管庫で矛盾を調整し、複数の情報源にまたがるパターンを自動的に統合したい場合。
• 押し返してくる思考ツールを使いたい場合：自分の過去の記録に照らして決定に異議を唱える、視点別のパネルを招集する、名前の付いていないパターンを見つける、無関係な領域を結び付ける。
• 調査結果を保管庫に取り込みたい場合：X の投稿を深く読み込む、X のトレンドを調べる、引用付きでウェブ調査を行う、保管庫を優先して詳細な調査を行う、情報源に基づいた NotebookLM の統合を行う、YouTube／ポッドキャストの文字起こしを取得する。
• Claude Code、Codex CLI、Gemini CLI、OpenCode（Hermes などのオープンモデルを含む）にセカンドブレインスキルをインストールしたい場合。
• コードベースをスキャンし、維持管理されるアーキテクチャノートを保管庫に書き込みたい場合（/obsidian-architect）。

実際の作業範囲がより狭い場合は、次に振り分けます。

• obsidian — Obsidian プラグイン開発、CLI 自動化、URI ハンドオフ、JSON Canvas、Bases のコンテンツパターン。
• llm-wiki — 基盤となる生の／wiki 形式の Markdown レイヤー、情報源の要約、クエリの分類、Lint の実行。
• okf — 保管庫をポータブルでベンダー中立な Open Knowledge Format バンドルとしてエクスポートする。
• notebooklm — 保管庫のワークフロー外で行う、情報源に基づいた NotebookLM の単独クエリ。
• scrapling — 保管庫への取り込みではなく、生のコンテンツ抽出のみが必要な場合の適応型ウェブスクレイピング。

jeo での呼び出し — $ エントリーポイント

jeo-code（jeo）では、スキルは $ エントリーポイントからのみ読み込まれ、/slash の入力では読み込まれません。aliases: のフロントマターには、検出用に 45 個すべての名前が jeo skills、スキルピッカー、シェルのオートコンプリートに登録されていますが、実際のトリガーは次のとおりです。

$obsidian-second-brain <command-or-intent> [args]

$obsidian-s（または曖昧さのない任意の接頭辞）でも解決されます。一方、裸の $obsidian は解決されません。完全一致する別個の obsidian スキルがあるためです。スキルトークンに続くすべての内容は、意図としてこのファイルに渡されます。意図を決定的に振り分けます。

1. 明示的なコマンド — 意図の最初の単語が 45 個のコマンド名のいずれかと一致する場合（先頭の / の有無、および obsidian- 接頭辞の有無を問わず）、そのコマンドを正確に実行し、残りの行を引数として扱います。次の入力はすべて /obsidian-ingest に振り分けられます。

   $obsidian-second-brain /obsidian-ingest https://example.com/post
   $obsidian-second-brain obsidian-ingest https://example.com/post
   $obsidian-second-brain ingest https://example.com/post
   

   その他の例：

   $obsidian-second-brain save                    → /obsidian-save
   $obsidian-second-brain reconcile               → /obsidian-reconcile
   $obsidian-second-brain challenge "migrate to X" → /obsidian-challenge
   $obsidian-second-brain research-deep "rag eval" → /research-deep
   $obsidian-second-brain world                   → /obsidian-world
   $obsidian-second-brain x-read <url>            → /x-read
   

   接頭辞なしのまま扱われる名前（obsidian- を付けないもの）：create-command、idea-discovery、notebooklm、podcast、research、research-deep、vault-deep-synthesis、x-pulse、x-read、youtube。

2. 自然言語の意図 — 最初の単語がコマンド名でない場合は、以下のステップ 1（レイヤー → コマンド）に沿ってリクエストを分類し、実行前に振り分け先を示します。例：$obsidian-second-brain save everything from this chat → 「Operations → /obsidian-save」。

選択したコマンドの動作、AI 優先の保管庫ルール、伝播は、スラッシュ版と同じです。異なるのはトリガー方法（/ ではなく $）だけです。すべてのコマンドはreferences/commands.mdを参照してください。

指示

ステップ 1 — リクエストを 4 つのレイヤーのいずれかに分類する

このスキルは、4 つのレイヤーと常時稼働の自動化レイヤーで構成されています。まずレイヤーを選び、次にコマンドを選びます。コマンドの完全な一覧はreferences/commands.mdにあります。

レイヤー	目的	ユーザーが求めていること
1 · 運用（28 個のコマンド）	Claude が記憶する	保存、取り込み、整合、エクスポート、日次メモ、タスク、人物、決定事項、カレンダー、プロジェクト／Vault の保守、アーキテクチャメモ
2 · 思考ツール（7 個のコマンド）	Claude が一緒に考える	アイデアへの異議申し立て、パネルの招集、パターンの発見、領域間の橋渡し、トピックの深い統合、次の方向性の順位付け、アイデアのプロジェクトへの昇格
3 · コンテキストエンジン（1 個のコマンド）	Claude があなたを把握する	段階的なトークン予算でアイデンティティと状態を読み込む（/obsidian-world）
4 · リサーチツールキット（7 個のコマンド）	Claude が知識を取り込む	X の閲覧／動向把握、ウェブ調査、Vault 優先の詳細調査、NotebookLM、YouTube、ポッドキャスト
常時稼働	Vault を稼働状態に保つ	バックグラウンドエージェント（コンパクション後）＋ 4 つのスケジュール済みエージェント（朝／夜間／週次／ヘルスチェック）＋保存リマインダー

実行前にルートを明示します。例：「運用 → /obsidian-ingest」 または 「リサーチ → /research-deep（Vault 優先）」。

ステップ 2 — 書き込みのたびに AI 優先の Vault ルールを守る

これは中核となる不変条件であり、モデルにかかわらず、すべてのノート書き込みに適用されます。

• 各ノートは ## For future Claude という前置きから始めます（このノートの内容、重要な理由、活用方法）。
• フロントマターは人間による確認ではなく、LLM による検索のためのものです（種類、タグ、最新性を示すマーカー、出典の原文）。
• 追記ではなく書き直す：出典によってページに深みが加わる場合や、内容が矛盾する場合は、ページを書き直し、その理由を記録します。
• 二時点の事実：ある事実がいつ真実だったかと、Vault がいつそれを把握したかを追跡します（「あなたは火曜日に X を信じていましたが、水曜日に Y を取り込んだ後、Z へと考えが変わりました」）。
• 2 出力ルール：回答するたびに、関連ページも更新します。
• raw/ は不変です。元の出典は編集せず、要約または書き直した内容のみを wiki/ に保存します。

ステップ 3 — 該当するコマンドを実行し、更新を反映する

効果の大きいワークフローは次のとおりです。

• /obsidian-save — 会話からすべての決定事項、人物、タスク、アイデアを抽出し、それぞれを適切なノートに振り分けます。
• /obsidian-ingest <url|file|image|audio> — 元のデータを raw/ に保存して（不変）、その後 5～15 個のエンティティ／概念ページを書き直し、矛盾を解消し、統合ページを作成して、index.md／log.md／日次ノートを更新します。
• /obsidian-reconcile — Vault 全体の矛盾を見つけて解消し、その理由を記録します。
• /obsidian-synthesize — 出典をまたぐ未命名のパターンを見つけ、統合ページを作成します。
• /obsidian-challenge — トピックに関する過去の失敗や撤回された決定事項を Vault から検索し、ユーザー自身の言葉を使って反論します。
• /research-deep <topic> — まず Vault を調べて不足点を特定し、Perplexity（ウェブ）＋ Grok（X）またはキー不要の無料ソースで不足分のみを補い、その後、人物／プロジェクト／アイデア全体に更新を反映します。Vault 優先とは、すでに把握している内容を再調査しないということです。

ステップ 4 — 求められた CLI 向けにインストール／ビルドする

インストール方法は CLI ごとに異なりますが、Vault の動作は同じです。全マトリックスと research-toolkit のキー表については、references/install.md を参照してください。

• プラグイン（この jeo-skill の入り口として推奨）： npx skills add https://github.com/akillness/jeo-skills --skill obsidian-second-brain（または bash scripts/install.sh）。
• jeo-code（jeo）： 自動的に検出されます。$ エントリーポイントから呼び出します — $obsidian-second-brain <command-or-intent>（jeo での呼び出しを参照）。aliases: フロントマターにある 45 個の名前は、検出用に jeo skills／ピッカー／オートコンプリートに表示されますが、jeo は /slash の入力からスキルを読み込みません。JEO=1 VAULT=<dir> bash scripts/install.sh でも、書き込み時に助言を行う AI ファーストのバリデーターを post-turn フックとして登録します（バックアップ付きで jq によりマージし、追記のみで冪等です。削除するには UNINSTALL=1 を指定します）。Claude 専用の / パレット、SessionStart ローダー、PostCompact エージェントは移植されていません — jeo にはこれらのフックイベントがありません。
• 上流の Claude Code： curl -fsSL https://raw.githubusercontent.com/akillness/obsidian-second-brain/main/scripts/quick-install.sh | bash を実行し、その後 /obsidian-init を実行します。
• 上流の Codex／Gemini／OpenCode： git clone を実行し、続けて bash scripts/build.sh --platform <codex-cli|gemini-cli|opencode> を実行して、dist/<platform>/ を Vault にコピーします。Codex では、名前付きコマンドのシムに bash scripts/install-codex-wrappers.sh が必要です。
• Research toolkit（任意）： .env.example を ~/.config/obsidian-second-brain/.env にコピーし、キーを追加して uv sync を実行します。または bash scripts/install.sh を実行し、research のプロンプトに「y」と答えます。/research と /research-deep はキーなしで動作します。

ステップ 5 — Vault を維持したい場合は自動化を設定する

• バックグラウンドエージェントは、コンテキストが圧縮されるたびに実行されます（PostCompact → ヘッドレスの claude -p → Vault を更新）。
• スケジュール済みエージェント：morning（毎日午前 8 時：デイリーノート＋期限超過項目）、nightly（午後 10 時：統合処理：終了＋照合＋統合＋孤立項目の修復＋インデックスの再構築）、weekly（金曜午後 6 時：レビュー）、health（日曜午後 9 時：監査）。
• 保存リマインダー：10 回以上やり取りした後、または「done」／「thanks」と言われたときに /obsidian-save を促します。

Vault のレイアウト、プリセット（executive／builder／creator／researcher）、エージェントの詳細については、references/vault-architecture.md を参照してください。

整合性を守るためのガードレール

• Vault の事実、引用、研究ソースを決して捏造しないでください。 研究ノートには、ソースをそのまま記録し、鮮度マーカー (as of YYYY-MM, source.com) を付けます。
• 追記ではなく書き換えますが、反対の主張を黙って破棄してはいけません — 照合し、監査証跡を残してください（双時点の事実）。
• raw/ の不変性を尊重してください — 元のソースは読み取り専用です。
• オープンモデルは Claude より指示に従わない傾向があります。 統合を多用するコマンド（/obsidian-architect、/obsidian-reconcile、/research-deep）では Claude または hermes-4-405b を優先してください。書き込み時には、AI ファーストの Vault ルールが常に適用されます。
• API キーはローカルに保存してください — ~/.config/obsidian-second-brain/.env に置き、chmod 600 を設定し、決してコミットしないでください。

参照ファイル

• references/commands.md — 層ごとに分類した 45 個すべてのコマンドと、そのトリガーおよび機能。
• references/install.md — 4 つの CLI のインストールマトリックス、Hermes／オープンモデルのセットアップ、research-toolkit のキー表。
• references/vault-architecture.md — Vault のレイアウト、プリセット、バックグラウンドおよびスケジュール済みエージェント、AI ファーストの Vault ルール。

上流：akillness/obsidian-second-brain （元：eugeniughelbur/obsidian-second-brain、MIT）。