Cross-Linker — 自動 Wiki クロスリファレンシング

wiki のナレッジグラフを密にするため、相互に参照すべきだが現在参照していないページ間の欠落した [[wikilinks]] を見つけて挿入します。

llm-wiki/SKILL.md の Retrieval Primitives テーブルに従ってください。 Step 1 でレジストリを構築する際は、frontmatter のみをグレップしてください (ページ全体ではなく)。フルボリューム読み取りを避けるために、完全な Read はリンク解除されたメンション検出パスのために予約しておきます。そこでも、サマリー/タイトルがリンク対象として妥当なページのみを読んでください。

開始前に

1. Config を解決 — llm-wiki/SKILL.md の Config Resolution Protocol に従ってください (CWD を上へ歩いて .env → ~/.obsidian-wiki/config → prompt setup)。これにより OBSIDIAN_VAULT_PATH と OBSIDIAN_LINK_FORMAT (デフォルト: wikilink) が得られます。
2. index.md を読んでページの完全なインベントリとそれぞれの 1 行説明を取得してください
3. log.md をスキップして最近インジェストされたものを確認してください (新しいページへのリンク作成に焦点を合わせます)

Step 4 でリンクを挿入する際、llm-wiki/SKILL.md のリンク形式セクションで OBSIDIAN_LINK_FORMAT の値を使用して適用してください。OBSIDIAN_LINK_FORMAT=markdown の場合、編集中のファイルからターゲットページへの相対 .md パスを計算してください。

Step 1: ページレジストリを構築

vault 内のすべての .md ファイルを glob してください (_archives/, .obsidian/ を除外)。各ページについて以下を抽出してください:

• ファイル名 (.md なし) — これが wikilink ターゲット
• frontmatter の Title
• frontmatter の Aliases (ある場合)
• frontmatter の Tags
• frontmatter の Category またはディレクトリ推測
• One-line summary — 最初の文または title フィールド

ルックアップテーブルを構築してください:

page_name → { path, title, aliases, tags, summary }

これはあなたの「語彙」です — このテーブル内のすべてのエントリは有効な wikilink ターゲットです。

Step 2: 欠落したリンクをスキャン

vault 内の各ページについて:

1. 完全なコンテンツを読む

2. 既存の wikilinks を抽出 — すでに存在するすべての [[...]] 参照を見つける

3. リンク解除されたメンションを検索 — ページのテキストに以下のいずれかが含まれているが、[[...]] で囲まれていないかどうかをチェック:

   • ページのファイル名 (例: "MyProject" という単語が表示されるが、[[projects/my-project/my-project]] がない)
   • frontmatter のページタイトル
   • frontmatter の Aliases
   • レジストリからのエンティティ名、プロジェクト名、概念名

4. セマンティック接続を確認 — 複数のタグを共有しているか同じプロジェクトディレクトリ内にあるが、相互にリンクしていないページ

マッチングルール

• 大文字小文字を区別しないマッチング 名前の場合 (例: "my-project" は MyProject ページにマッチ)
• ダイアクリティック非感応マッチング — Unicode NFKD で両方のページ名とボディテキストを正規化してください (アクセント文字を base + combining marks に分解し、combining marks をストリップ)。これにより、ボディテキスト "Muller" が [[entities/müller]] ページにマッチすることを保証し、その逆も同様です。
• 自己参照をスキップ — ページはそれ自身にリンクすべきではありません
• 一般的な単語をスキップ — "the"、"and"、一般的な用語をリンクしないでください。distinctive な名前のみマッチさせてください
• 最短の曖昧でない wikilink パスを優先 — 名前がバルト全体でユニークな場合、[[full/path/to/page-name]] ではなく [[page-name]] を使用してください
• コードブロック内やfrontmatter内でリンクしないでください
• 二重リンクしないでください — [[foo]] がすでにページに表示されている場合、別のリンクを追加しないでください

Step 3: 提案をスコアリングとランク付け

すべての可能なリンクが追加する価値があるわけではありません。複合信号を使用して各候補をスコアリングし、信頼度ラベルでタグ付けしてください。

スコアリング

シグナル	ポイント	例
テキストのエキゾチックな名前マッチ	+4	"MyProject" がボディテキストに表示 → my-project.md にリンク
共有タグ (2 以上)	+2	両方が #ai #agent でタグ付けされているが、その間にリンクがない
同じプロジェクト、リンクなし	+2	両方が projects/my-project/ の下にあるが、相互に参照していない
メンション対象のエンティティ/概念	+2	ページが「knowledge graphs」に言及 → [[concepts/knowledge-graphs]] にリンク
クロスカテゴリー接続	+2	ソースが concepts/ 内、ターゲットが entities/ 内 (または skills/ ↔ synthesis/) — 異なるナレッジレイヤーがこのリンクをアーキテクチャ的により価値あるものにします
周辺 → ハブ到達	+2	ソースページは ≤ 2 個のリンク (周辺) 但しターゲットは ≥ 8 個 (ハブ) — 疎いページを負荷のかかる概念に接続
部分的な名前マッチ	+1	"graph" が表示されるがページは knowledge-graphs — 妥当だが曖昧

信頼度ラベル

スコアに基づいて各候補に信頼度ラベルを付けてください:

スコア	ラベル	アクション
≥ 6	EXTRACTED	リンクは本質的に確実 — エキゾチックなメンション或いは非常に強力なマッチ。インラインで適用してください。
3–5	INFERRED	リンクは合理的な推論 — 共有コンテキスト、クロスカテゴリー、周辺 → ハブ。インラインで適用するか Related セクションで。
1–2	AMBIGUOUS	弱いまたは部分的なマッチ。ユーザーが特に疎いページを接続することを求めない限りスキップしてください。

EXTRACTED および INFERRED 候補のみで行動してください。ユーザーが INFERRED リンクを信頼する前にレビューできるように、Cross-Link Report に信頼度ラベルを含めてください。

Step 4: リンクを適用

欠落したリンクがある各ページについて:

4a: インラインリンク (推奨)

ボディテキスト内の用語の最初の自然なメンションを見つけて wikilinks でラップしてください:

Before:

This project uses knowledge graphs to connect entities.

After:

This project uses [[concepts/knowledge-graphs|knowledge graphs]] to connect entities.

wikilink パスが表示テキストと異なる場合、[[path|display text]] 形式を使用してください。

4b: Related セクション (フォールバック)

用語がボディ内に自然に言及されていないがページがセマンティック上、関連している場合 (共有タグ、同じプロジェクト)、ページの下部に ## Related セクションを追加してください:

## Related

- [[projects/my-project/my-project]] — Also uses AI agents for research automation
- [[concepts/knowledge-graphs]] — Core technique used in this project

## Related セクションが既に存在する場合、それに追加してください。既存のエントリを重複させないでください。

4c: 関係タイプを推測して記述

追加されたすべての EXTRACTED または INFERRED リンク (インラインまたは related セクション) について、周囲の文脈からセマンティックな関係タイプを推測し、ページの relationships: frontmatter ブロックに記述してください。AMBIGUOUS リンクはスキップしてください。

タイプ推測ルール — メンションを含む文 (または related-section リンクの場合、ページタイトルと共有タグコンテキスト) をスキャンしてください:

文パターン	推測タイプ
"X extends / builds on / generalises Y"	extends
"X implements / is an implementation of Y"	implements
"X contradicts / opposes / refutes / is at odds with Y"	contradicts
"X is derived from / based on / adapted from Y"	derived_from
"X uses / relies on / depends on / requires Y"	uses
"X replaces / supersedes / deprecates Y"	replaces
共有タグまたは方向性キューのないクロスカテゴリー推測	related_to

周囲のコンテキストが曖昧な場合またはリンクが共有タグマッチング (ボディ内メンションなし) から来た場合、デフォルトは related_to。

ブロックを記述:

ページの YAML frontmatter を読んでください。relationships: ブロックが既に存在する場合、既存ターゲットを重複させずに新しいエントリを追加してください。ブロックが存在しない場合、aliases: の後に追加してください (aliases: がない場合は tags: の後)。

relationships:
  - target: "[[concepts/knowledge-graphs]]"
    type: uses

常に wikilink 形式 ([[path/to/page]]) を relationships: YAML ブロックの target 値に使用してください — OBSIDIAN_LINK_FORMAT に関わらず。OBSIDIAN_LINK_FORMAT 設定はボディコンテンツを制御します; frontmatter プロパティは常に wikilink シンタックスを使用するため、wiki-export が確実に解析できます。

このクロスリンカー実行で追加されたリンクのエントリのみを追加してください — すでに存在していた型付きエントリには触れないでください。

Step 5: Misc ページアフィニティをスコアリング

メインのリンク作成パス後、misc/ のすべてのページのアフィニティスコアを更新してください (frontmatter に promotion_status: misc を持つページ、または misc/ ディレクトリ配下のページ)。

各 misc ページについて:

1. アウトゴーイングリンクを収集 — ページボディ内のすべての [[wikilinks]]
2. インカミングリンクを収集 — [[misc/<slug>]] と [[<slug>]] 参照について vault をグレップ
3. リンク済みの各ページ (両方向) について、プロジェクトに属しているかチェック:
   • projects/<project-name>/ の下に存在
   • プロジェクト名に一致する project: frontmatter フィールドがある
4. プロジェクト名でグループ化して合計: outgoing_links + incoming_links
5. misc ページの affinity frontmatter ブロックを更新してください:

affinity:
  obsidian-wiki: 3
  another-project: 1

6. いずれかのプロジェクトのスコアが ≥ 3 の場合: このページを promotion candidate としてフラグを立てて、レポートに記録してください

効率に関する注記: misc ページのフルボディのみを読んでください — 他のページは、プロジェクトメンバーシップを判定するため frontmatter grep のみが必要です。

Step 6: レポート

サマリーを提示してください:

## Cross-Link Report

### 追加されたリンク: 12 ページ全体で 23 個

| ページ | 追加されたリンク | 信頼度 | 配置 | 関係タイプ |
|---|---|---|---|---|
| `projects/my-project/my-project.md` | 3 | EXTRACTED | 2 inline, 1 related | uses ×2, related_to ×1 |
| `entities/jane-doe.md` | 5 | INFERRED | 3 inline, 2 related | extends ×1, uses ×3, related_to ×1 |
| ... | | | | |

### 残存する Orphan ページ: 2
- `references/foo.md` — インカミング またはアウトゴーイングリンクが見つかりません
- `concepts/bar.md` — 関連ページが見つかりません

### Misc Promotion Candidates: N
misc/ 内のページで、単一プロジェクトへの接続が ≥ 3 — 昇格準備完了:

| ページ | トップ プロジェクト | スコア |
|---|---|---|
| `misc/web-martinfowler-articles-microservices.md` | `obsidian-wiki` | 4 |

昇格するには: ページを `projects/<project-name>/references/` に移動して、すべてのバックリンクを更新してください。

### スキップされたページ: 3
- `index.md`, `log.md` — 特別ファイル
- `_archives/*` — アーカイブされたコンテンツ

Step 7: ログと Hot Cache を更新

log.md に追記してください:

- [TIMESTAMP] CROSS_LINK pages_scanned=N links_added=M typed_relations_written=T pages_modified=P orphans_remaining=Q misc_affinity_updated=R promotion_candidates=S

hot.md — $OBSIDIAN_VAULT_PATH/hot.md を読んでください (missing の場合 wiki-ingest の template から作成)。Recent Activity を何がリンクされたかの 1 行サマリーで更新してください — 例: "Cross-linked 23 mentions across 12 pages; 2 orphans remain." 最後の 3 操作をキープしてください。updated タイムスタンプを更新してください。

Tips

• すべてのインジェスト後に実行してください。 新しいページはほぼ常に接続が悪くなっています。これが修正です。
• インラインリンクは慎重に。 最初の自然なメンションのみをリンクしてください、すべてのオカレンスではなく。
• _archives/ のページに触れないでください。 それらは凍結されたスナップショットです。
• 既存の構造を尊重してください。 ページが ## Key Concepts セクションのリンクを注意深くキュレーションしている場合、別の ## Related を作成するのではなく、そのセクションに追加してください。
• エンティティページはリンクマグネット。 jane-doe のようなエンティティは、ほぼすべてのプロジェクトページからリンクされるべきです。これらを優先してください。