internal-link-graph-architect

内部链接图架构师

在 information-architecture-seo 定义页面角色和规范网址策略后，使用此技能。

在生成完整链接图之前，请阅读 references/link-graph-rules.md。

负责范围

• 有意规划的内部链接图；
• 简报到长篇内容及长篇内容到简报的链接；
• 面包屑；
• 主题、项目、作者、社区和来源轨迹链接；
• 锚文本意图；
• 孤立页面检查；
• 过度链接和意图重复风险检查。

不负责范围

• 规范网址和 hreflang 策略；
• 最终 URL 架构；
• 外部反向链接布局；
• 隐藏链接；
• 视觉 UI 布局；
• Schema 实现。

工作流

1. 阅读 url-map.yaml、页面角色、规范网址模型、语言分组和内容模型。
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. 将 Schema／head 相关事项交接给 technical-seo-schema-engineer，并将渲染后的导航检查交接给 ui-ux-llm-product-architect。

链接规则

• 每个链接都必须有用户理由。
• 如果存在长篇文章，简短简报应链接到该文章。
• 如果简报仍作为独立新闻页面存在，长篇文章应链接回该简报。
• 主题页面通过摘要组织相关页面；不得重复故事正文。
• 作者和项目链接应有助于建立信任并理解实体。
• 面包屑用于明确层级；不得堆砌关键词。
• 相关链接应精简且理由充分。
• 外部权威网站的链接布局不在此范围内。

安全与隐私边界

• 不得推荐隐藏链接、伪装链接、注入页脚、不相关的精确匹配锚文本或链接堆砌。
• 不得从公共页面链接到管理页面、私有 API、私有分析数据、原始 IP 日志、暂存 URL、机密文件或未发布的草稿。
• 不得为了增加链接数量而创建额外的公共故事页面。
• 不得为了 SEO 锚文本而损害用户体验或无障碍访问。

验证

标记工作完成前：

• 每个链接都包含来源 URL、目标 URL、类型、锚文本意图、用户理由、SEO 理由和风险；
• 每个预期可被发现的页面至少有一个合乎逻辑的入站链接；
• 简报和长篇页面成对关联，且不会产生额外的故事正文；
• 主题／项目／作者链接具有实体或导航用途；
• 不包含隐藏或不相关的链接建议。

使用以下内容验证技能编辑：

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／Schema 和 UX 的交接说明。