Graph Colorize — Obsidian グラフビューをカラーコーディングする

$OBSIDIAN_VAULT_PATH/.obsidian/graph.json を書き換えて、Obsidian のグラフビューのノードをタグ、フォルダ、または可視性で色分けします。

Obsidian はグラフ設定を <vault>/.obsidian/graph.json に保存しています。colorGroups 配列は {query, color} ペアのリストであり、ノードごとに最初にマッチしたクエリが優先されます。クエリは Obsidian の検索構文を使用します: tag:#foo、path:"concepts"、file:foo など。色は {"a": 1, "rgb": <packed-int>} の形式で、整数は (R << 16) | (G << 8) | B です。

開始する前に

1. 設定を解決する — llm-wiki/SKILL.md の Config Resolution Protocol に従います（CWD で .env を探す → ~/.obsidian-wiki/config → プロンプト設定）。これにより OBSIDIAN_VAULT_PATH が得られます。
2. $OBSIDIAN_VAULT_PATH/.obsidian/ が存在することを確認してください。存在しない場合、Vault が Obsidian で一度も開かれていません — ユーザーに Obsidian で Vault を一度開いてから再実行するよう指示してください。
3. Obsidian が開いている可能性があることを警告します: Obsidian は終了時に graph.json を上書きします。Vault を先に閉じるか、リロード（Cmd/Ctrl+R）に備え、リロードするまでグラフ設定に触らないよう指示してください。

ステップ 1: モードを選択する

ユーザーの表現からモードを推測してください。曖昧な場合は by-tag をデフォルトとします。

ユーザーの意図	モード
「タグで色分け」、「グラフを色分けして」、「カラフルにして」（デフォルト）	by-tag
「フォルダで色分け」、「カテゴリで色分け」、「ディレクトリで色分け」	by-category
「可視性をハイライト」、「グラフに internal/pii を表示」、「可視性の色」	by-visibility
ユーザーが明示的なマッピングを提供（tag:#foo = red、または JSON blob）	custom
「タグと可視性を組み合わせて」／「両方」	combined（可視性を先に、その後タグ）

ステップ 2: colorGroups 配列を構築する

パレット（10色、色覚障害に配慮した色）

順に使用してください。グループ数が色数より多い場合は、循環させて、明るさを約20% の分割で調整するか、10色でキャップして、残りのタグは「その他」の色を共有することをユーザーに伝えてください。

#	Hex	rgb（パック整数）	役割
0	#4E79A7	5142951	青
1	#F28E2B	15896107	オレンジ
2	#E15759	14767961	赤
3	#76B7B2	7780786	ティール
4	#59A14F	5873999	緑
5	#EDC948	15583048	黄
6	#B07AA1	11565217	紫
7	#FF9DA7	16751527	ピンク
8	#9C755F	10253663	茶
9	#BAB0AC	12234924	グレー

すべての色は {"a": 1, "rgb": <int>} でラップされます。

モード: by-tag

1. $VAULT_PATH/**/*.md をグロブして、_archives/、_raw/、.obsidian/、node_modules/、index.md、log.md、_insights.md を除外します。
2. 各ページの frontmatter から tags をパースします。タグごとの使用数をカウントします。
3. visibility/* タグを頻度リストから削除します — これらはシステムタグであり、by-visibility または combined モードでのみ処理されます。
4. 使用頻度の上位 10 タグを取得します。10 未満の一意なタグがある場合は、すべてを使用します。
5. インデックス i の各タグ T について: {"query": "tag:#T", "color": palette[i]} を出力します。
6. オプションで、タグなしページの最後にキャッチオール エントリを追加: {"query": "-[\"tag\":]", "color": palette[9]} — 色スロット 9 が実際のタグで既に占有されている場合は スキップ してください。

モード: by-category

7 つのボルト トップレベル フォルダを固定順で使用して、実行間で色が安定します:

フォルダ	色インデックス
concepts	0（青）
entities	1（オレンジ）
skills	2（赤）
references	3（ティール）
synthesis	4（緑）
projects	5（黄）
journal	6（紫）

存在し、かつ少なくとも 1 つの .md ファイルを含むフォルダごとに 1 つのエントリを出力します。各エントリは:

{"query": "path:\"<folder>\"", "color": {"a": 1, "rgb": <int>}}

モード: by-visibility

この順序で正確に 3 つのエントリを出力します（最初のマッチが優先されるため、最も制限的なものが最初）:

1. visibility/pii → #E15759（赤、rgb 14767961）
2. visibility/internal → #F28E2B（オレンジ、rgb 15896107）
3. visibility/public → #59A14F（緑、rgb 5873999）

{"query": "tag:#visibility/pii", "color": {"a": 1, "rgb": 14767961}}

visibility/ タグのないページは Obsidian のデフォルト色のままです — キャッチオールを追加しないでください。

モード: combined

by-visibility エントリを最初に出力し、その後 by-tag エントリを出力します。可視性がリストの最初に表示されるため、競合では可視性が優先されます。

モード: custom

ユーザーが明示的なマッピングを指定した場合は、それらをそのまま尊重してください。ユーザーが指定した任意の 16 進数（例: #FF00FF）を int(hex_without_hash, 16) を使用してパック整数に変換してください。各を {"a": 1, "rgb": <int>} でラップしてください。

ステップ 3: graph.json にマージ（上書きしない）

1. 既存の $VAULT_PATH/.obsidian/graph.json を読み込みます。存在しない場合は、このデフォルトから開始します:

   {
     "collapse-filter": true,
     "search": "",
     "showTags": false,
     "showAttachments": false,
     "hideUnresolved": false,
     "showOrphans": true,
     "collapse-color-groups": false,
     "colorGroups": [],
     "collapse-display": true,
     "showArrow": false,
     "textFadeMultiplier": 0,
     "nodeSizeMultiplier": 1,
     "lineSizeMultiplier": 1,
     "collapse-forces": true,
     "centerStrength": 0.518713248970312,
     "repelStrength": 10,
     "linkStrength": 1,
     "linkDistance": 250,
     "scale": 1,
     "close": true
   }
   

2. 最初にバックアップします: 書き込む前に既存ファイルを .obsidian/graph.json.backup-<YYYYMMDD-HHMM> にコピーします。同じ分のバックアップが既に存在する場合は再利用します — 重複を蓄積しないでください。

3. のみ colorGroups フィールドを新しい配列で置き換えます。他のすべてのフィールドはそのままにします。これにより、ユーザーのズーム、物理演算、フィルター、検索、および表示設定が保持されます。

4. 元の JSON スタイルと同じでファイルを書き込みます（通常はコンパクト シングルライン または 2 スペース インデント — 既存のものを保持してください）。

ステップ 4: レポートとログ

次のようなサマリーを出力します:

Graph colorized → .obsidian/graph.json
  Mode:    by-tag
  Groups:  7 color assignments
  Palette: blue, orange, red, teal, green, yellow, purple
  Backup:  .obsidian/graph.json.backup-20260424-1432

Reload Obsidian (Cmd/Ctrl+R) to see the new colors.
If Obsidian is currently open, close it first OR reload immediately — Obsidian
overwrites graph.json on close and can erase these changes.

$VAULT_PATH/log.md に追記します:

- [TIMESTAMP] GRAPH_COLORIZE mode=<mode> groups=<N> backup=graph.json.backup-<stamp>

エッジケース

• Vault にタグがない by-tag モードの場合 → by-category にフォールバックしてユーザーに伝えます。
• ユーザーが元に戻したい → 最新の graph.json.backup-* から復元し、log.md に記録します。
• ユーザーがすべてのカラー グループをクリアしたい → colorGroups: [] を設定し、バックアップして、mode=clear として log.md に記録します。
• .obsidian/ がない → Vault が Obsidian で一度も開かれていません。ユーザーに一度開くよう指示してから再実行してください。自分で .obsidian/ を作成しないでください — Obsidian は最初のオープン時に多くのファイルをそこに設定します。
• クエリ構文のいくつかの落とし穴: スペース付きフォルダ パスは引用符が必要です（path:"my folder"）; ネストされたスラッシュ付きタグは文字通り機能します（tag:#visibility/internal）; URL エンコードしないでください。
• 編集中に Obsidian が開いている: リスクをサーフェスします — Obsidian は起動時に graph.json を読み込み、終了時に 書き直します。ユーザーがライブで編集している場合は、先に Obsidian を閉じるか、すぐにリロード（Cmd/Ctrl+R）を実行してリロード前にグラフ設定を開かないよう指示してください。

注記

• これは純粋な設定編集です — ページ コンテンツの変更なし、frontmatter 書き込みなし。
• 再実行は安全です: 各実行で新しいバックアップが作成され、colorGroups のみが書き直されます。
• ユーザーが手動でキュレートしたカラー グループを保持したい場合は、combined モードを提供するか、上書きする前に確認してください。
• ここのパレットは wiki-export の graph.html コミュニティ色と一致するため、Obsidian グラフとエクスポート されたビジュアライゼーションは一貫性を持ちます。