Communitygithub.com

spikesubingrui-design/u

U — エージェントがあなたに対して持つ記憶を、Obsidian グラフとして可視化します。OpenClaw + gbrain 知識グラフを一元管理し、重複取り込みゼロ。

u とは?

U は、OpenClaw の memory_search と gbrain の Postgres 知識グラフという、エージェント側ではアクセス可能だが人間には見えにくい記憶を、Obsidian のグラフビューで可視化するスキルです。gbrain の Wiki リポジトリを Obsidian の Vault として開き、OpenClaw のメモリディレクトリをシンボリックリンクで取り込み、さらに `gbrain export` によってデータベース上のページをマークダウンファイルとして書き出すことで、**一つのファイル群を三つの異なる索引(Obsidian のグラフ、ファイルシステム、ベクトル検索)で扱える**ようにします。主要なセットアップはワンスクリプトで完了し、その後は `distill-candidates.py` による日記からの話題抽出提案、`references/knowledge-curation.md` による知識キュレーション憲法、`scripts/recall.mjs` による6段階検索パイプラインといった高度な機能を順次追加できます。主な対応プラットフォームは OpenClaw、gbrain、Obsidian で、エージェントの実行環境(CLI、Cron)で動作します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add spikesubingrui-design/u

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

U ——「あなた」の記憶、ついに可視化

問題:OpenClaw の memory_search や gbrain の Postgres グラフはエージェントから見えても、人間からは見えません。 解決法:Obsidian で gbrain wiki を Vault として開き、memory/ 日記をシンボリックリンクで取り込み、必要に応じて gbrain export で DB 上のページをマークダウンに書き出します——1セットのファイル、3方向の索引。

このスキルをロードするタイミング

  • ユーザーが Obsidian と OpenClaw memory / gbrain を連携させたい場合
  • ユーザーが「セカンドブレインの可視化」「memory グラフ」「点と点をつなぐ」「Obsidian でエージェントが書いた記憶を見たい」と言った場合
  • ユーザーがすでに gbrain + ~/wiki(または同種のマークダウン脳内ライブラリ)を持っており、GUI を追加したい場合

アーキテクチャ(一図で)

OpenClaw workspace/memory/*.md  ──symlink──►  ~/wiki/memory/     ◄── Obsidian で閲覧
gbrain Postgres (426+ pages)   ──export──►  ~/wiki/**/*.md       ◄── Obsidian グラフ
Agent cron                     ──sync────►  Postgres + vectors   ◄── バックエンドはそのまま

セキュリティ制約(必ず遵守):

  • memory は ~/wiki/.gitignore に含める → gbrain の sync は git-diff 駆動のため、日記が重複して取り込まれない
  • .obsidian/ は gbrain の isSyncable でスキップされる(隠しディレクトリ)
  • alwaysUpdateLinks: true を変更しない(Obsidian が gbrain の [[パス形式]] リンクを一括書き換えるのを防ぐ)

Phase 0 — パスの確認

変数デフォルト説明
WIKI_DIR~/wikigbrain git リポジトリのルート
MEMORY_DIR~/.openclaw/workspace/memoryOpenClaw 日記 MD
GBRAIN_BINgbrainPATH 上の CLI

Phase 1 — ワンクリックセットアップ(推奨)

bash skills/u/scripts/setup-vault.sh
# またはパスを指定:
WIKI_DIR=~/wiki MEMORY_DIR=~/.openclaw/workspace/memory bash scripts/setup-vault.sh

スクリプトは以下を実行:memory シンボリックリンクの作成、.gitignore への追記、.obsidian/app.json のプリセット(wikilink + absolute + リンク自動変更オフ)。

Phase 2 — DB ページの実体化(任意だが強く推奨)

Postgres 上のページがディスク上の .md より多い場合(MCP put_page が DB にのみ書き込む場合に発生):

gbrain export --dir "$WIKI_DIR"
cd "$WIKI_DIR" && git add -A && git commit -m "materialize gbrain pages for Obsidian"

実体化後、Obsidian グラフの wikilink 解決率は通常 ~28% から 84% に向上(README 同条件)。

Phase 3 — Obsidian を開く

  1. Obsidian → フォルダを Vault として開く → WIKI_DIR を選択
  2. 左側の グラフビュー:people / projects / concepts / synthesis のクラスターを確認
  3. memory/2026-MM-DD.md を開く → 右ペインの バックリンク → 未リンクのメンション から、その日記を参照する gbrain ページにジャンプ

Phase 4 — 検証チェックリスト

  • ls -la $WIKI_DIR/memory がシンボリックリンクを表示する
  • cd $WIKI_DIR && git status に memory/*.md が表示されない
  • グラフにリンクが存在する([[projects/foo]] が解決されている)
  • gbrain ページを編集して保存後、git status に変更が表示される(cron が sync + embed を行う)

Phase 5 — 点と点をつなぐ:抽出候補(任意、v1.1)

グラフが見えるようになった次の課題:日記に繰り返し登場する話題を、どうグラフページにするか?よくある 2 つの悪い方法——エージェントが判断して直接ページを書く(間違っても修正されずグラフに残る)、あるいは誰も書かない(グラフが常に日記より遅れる)——を避けるため、distill-candidates.py は中間の道を選びます:提案のみ、執筆は行いません。

python3 skills/u/scripts/distill-candidates.py --dry-run

実行内容:MEMORY_DIR 内の直近 14 日間の日記をスキャンし、WIKI_DIRS(デフォルトは people,companies,projects,concepts)内の既存ページの title/aliases から語彙リストを構築。「2 日以上にわたって繰り返し」現れる話題を抽出し、distill-inbox.md を Vault ルートに書き出します。A 領域は既存ページに追いついていないもの、B 領域は繰り返し現れるがまだページがない候補です。--dry-run を外すと実際に書き込みます。書き込むのは distill-inbox.md と .distill_heartbeat.json の 2 ファイルのみ。memory/ やグラフページには一切触れません。

候補を受け入れる場合は、あなた(またはエージェント)がそのページを更新・新規作成します——このステップは意図的に人間に委ねられており、これをスキップすることが自動記憶システムで最も問題を起こしやすい箇所です。

cron に組み込んで、キューを毎日自動更新することも可能(それでも提案のみ):

# OpenClaw
openclaw cron create --no-agent --script skills/u/scripts/distill-candidates.py "0 3 * * *"

Phase 6 — キュレーション憲法:役立つグラフ、単なる見た目の良い積み上げではない(v1.2)

キュー(Phase 5)で「誰が品質をチェックするか」は解決しましたが、「どの基準で書くか」が残っています。放置すると、Vault は別の死に方をします:ページは増え続け、どれも一見完全に見えるが、将来の実際の質問でヒットするページは一つもない——一見完璧な知識の積み上げ。

references/knowledge-curation.md はグラフを書くエージェントへのシステムプロンプトです。ページの作成・編集・分類を行う前に必ず読んでください。核となる判断基準は一言:ある知識が役立つのは、それが将来の実際の質問にヒットし、答えを返せる場合のみ。

  • 収録の3つの問い(いずれかが「いいえ」ならページを作成しない):行動を変えるか?再び質問されるか?モデルが持つ知識よりも優れているか?
  • 分類ルーブリック:ディレクトリごとに判断基準と正例・反例を設定。「エージェントの分類が不正確」という問題に対処。
  • 密度基準:追加よりも書き換えを優先。最初の3行で勝負。各ページには必ず「このページが答えるべき質問」セクション(2~5 個の実際の質問)を含める。
  • ⭐ 質問 - 回答のフィードバックループ:エージェントが優れた回答を合成した場合、日記に ⭐page-candidate: <質問案> を記録(中国語 ⭐候选页: も可)。v1.2 の distill-candidates.py はこれをキュー B 領域の最上位に昇格させます。ページを作成したら ⭐ を ✅ に変更することで、リストに再表示されなくなります。キューをバイパスして直接ページを作成することは禁止されています。
  • D 領域:再構築候補:スクリプトが自動的に「アップデートパッチだらけ」の肥大化ページをスキャンし、受け入れ後に憲法 §5 のテンプレートに従って密度の高い単一ページに溶接(検収基準:30%+ 短縮かつ情報欠落ゼロ)。
  • 高度な機能(自分で配線する必要あり、憲法 §6 に実装方法あり):検索ログのミス → ページ作成シグナル、45 日間ヒットなし → 退役提案、毎月の矛盾チェック。

憲法をエージェントの指示(AGENTS.md / CLAUDE.md)に組み込むには、以下の 1 行を追加するだけ:

wiki ページを作成・編集する前に skills/u/references/knowledge-curation.md を読む(収録の3問+ルーブリック+密度基準)。追加よりも書き換えを優先。

Phase 7 — 検索パイプライン:「2つをマージ」から真の再現へ(v1.3)

キュレーション憲法で「何を書くか」は解決しましたが、残る半分は「見つかるか」です。実際に試した結果:memory_search(キーワード)と gbrain query(ベクトル)を単純にマージし、スコアでソートしてトップ20を切り出す方法では、実際の質問(「XX とは誰か」のような完全な文)に対して10 件中 0 ヒット、MRR は 0 でした。原因:ベクトルエンジンが多語の中国語や疑問文に対して直接ゼロ結果を返す(同じエンティティを単一単語で検索すると 0.7+ のスコアになるにもかかわらず)。

scripts/recall.mjs を 6 段階のパイプラインに書き換えたところ、同じ評価セットで 0/10 から 10/10(MRR 0→0.75)を達成:

  1. クエリ正規化——原文 + 疑問詞除去コア文 + あなた自身の wiki の title/aliases から構築したエンティティテーブルからの実体語抽出 + CJK 接頭辞 n-gram
  2. 二重エンジン分担——キーワードエンジンは低速、原文 + 2 つの実体語のみ送信;ベクトルエンジンは高速、すべてのバリアントを送信
  3. RRF 融合(k=60)——異なるエンジンのスコアは比較不能だが、順位は比較可能;正規化不要
  4. 時間減衰 + 頻度——コンテンツカテゴリに応じて半減期を設定、下限 0.5 で強いヒットが埋もれないようにする
  5. MMR による冗長除去(λ=0.7)——トップ K が類似した断片で埋まるのを防止
  6. 1 ホップグラフ展開——ヒットページからのリンク先ページを割引ありで一緒に出力
bun scripts/recall.mjs "<クエリまたは完全な質問文>"

付属評価ツール scripts/recall-eval.mjs——「なんとなく正確になった」は結論ではなく、数字で確認します。ops/recall-eval.example.jsonl(架空のサンプル)から始めて、あなた自身の実際の質問に置き換えてください:

bun scripts/recall-eval.mjs --eval ops/recall-eval.jsonl

recall.mjs のパラメータを変更する前に、必ずまず評価セットを実行してください。感覚だけで判断しないこと。 完全な設計意図、各ステップの「なぜ」については references/retrieval-pipeline.md を参照。

オプション:定期的に評価セットのヘルスチェック cron を実行。合格率がしきい値を下回った場合のみアラートを発し、全緑の場合は静か——埋め込みの期限切れ、エンジンのダウン、パラメータの改悪など、自動的には通知されない静かな劣化を防ぎます。

エージェント書き込み規則(AGENTS.md メモリブリッジと一致)

ユーザーが Obsidian でマークダウンを手動編集した場合:

  • gbrain 側:link-maintenance / auto-ingest cron が sync --no-embed + embed --stale を実行
  • memory 側:引き続き workspace/memory/ にあり、memory_search が索引付け。memory を wiki git にコミットしないこと。

トラブルシューティング

症状対処
グラフが非常にスカスカ、大量の浮遊リンクgbrain export --dir $WIKI_DIR を実行
memory が git に表示される.gitignore に memory が含まれていることを確認
Obsidian がリンクを [text](path) に変更するuseMarkdownLinks: false を確認
[[Naval Ravikant]] が解決されない表示名リンク。対象ページの frontmatter に aliases を追加

関連

  • skills/brain-ops — gbrain 書き込み仕様
  • skills/memory-setup-openclaw — memory_search 設定
  • skills/planning-with-files — 長時間タスクを memory に保存

詳細なアーキテクチャと mermaid 図は references/architecture.md を参照。

関連スキル