internal-link-graph-architect

内部リンクグラフ設計者

information-architecture-seo でページの役割と正規化ポリシーを定義した後に、このスキルを使用してください。

完全なグラフを作成する前に、references/link-graph-rules.md を読んでください。

担当範囲

• 意図的な内部リンクグラフ；
• 簡易記事から長文記事へのリンク、および長文記事から簡易記事へのリンク；
• パンくずリスト；
• トピック、プロジェクト、著者、コミュニティ、出典の導線へのリンク；
• アンカーの意図；
• 孤立ページの確認；
• 過剰なリンクと意図の重複によるリスクの確認。

担当範囲外

• canonical と hreflang のポリシー；
• 最終的な URL アーキテクチャ；
• 外部被リンクの配置；
• 非表示リンク；
• ビジュアル UI レイアウト；
• スキーマの実装。

ワークフロー

1. url-map.yaml、ページの役割、canonical モデル、言語グループ、コンテンツモデルを読みます。
2. 必須の構造的リンクを特定します。パンくずリスト、簡易記事と長文記事のペア、トピック／プロジェクト／著者／エンティティへのリンクが含まれます。
3. 出典の導線へのリンクは、ユーザーに表示され、有用な場合にのみ追加します。
4. link_type、anchor_intent、user_reason、seo_reason、risk を設定します。
5. 孤立ページ、目的のない循環リンク、無関係な完全一致アンカー、重複する記事本文のルートにフラグを立てます。
6. assets/internal-link-graph.template.yaml を使用して internal-link-graph.yaml を作成します。
7. スキーマ／head に関する事項は technical-seo-schema-engineer に、レンダリング後のナビゲーション確認は ui-ux-llm-product-architect に引き継ぎます。

リンクのルール

• すべてのリンクにはユーザーにとっての理由が必要です。
• 長文記事がある場合、簡易記事から該当する長文記事へリンクする必要があります。
• 簡易記事が独立したニュースページとして残る場合、長文記事から簡易記事へリンクする必要があります。
• トピックページでは、関連ページを要約とともに整理します。記事本文を重複させてはいけません。
• 著者やプロジェクトへのリンクは、信頼性とエンティティの理解を支えます。
• パンくずリストは階層を明確にするためのものであり、キーワードを詰め込むものではありません。
• 関連リンクは最小限にし、妥当性を説明できるものにします。
• 外部権威サイトへのリンク配置は担当範囲外です。

安全性とプライバシーの境界

• 非表示リンク、クローキングされたリンク、挿入されたフッター、無関係な完全一致アンカー、リンクの詰め込みを推奨しないでください。
• 公開ページから、管理画面、非公開 API、非公開分析データ、生の IP ログ、ステージング URL、秘密ファイル、未公開の下書きへリンクしないでください。
• リンク数を増やすために、公開記事ページを追加作成しないでください。
• SEO アンカーのために UX やアクセシビリティを損なわないでください。

検証

作業完了とする前に、以下を確認します。

• すべてのリンクに、ソース URL、ターゲット URL、タイプ、アンカーの意図、ユーザーにとっての理由、SEO 上の理由、リスクがある；
• 発見可能であるべきすべてのページに、論理的な被リンクが少なくとも 1 つある；
• 簡易記事と長文記事のページが、記事本文を追加で作成することなくペアになっている；
• トピック／プロジェクト／著者へのリンクに、エンティティまたはナビゲーション上の目的がある；
• 非表示または無関係なリンクの推奨が含まれていない。

スキルの編集内容を次のコマンドで検証します。

python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/internal-link-graph-architect
python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL

フォワードテストは evals.json にあります。

出力形式

以下を返します。

1. リンクグラフの概要。
2. 必須の構造的リンク。
3. 任意の関連リンク。
4. 孤立ページ／過剰リンクのリスク。
5. テクニカル SEO／スキーマと UX への引き継ぎ事項。