用途:在信息架构与 SEO 已确定页面角色和规范化策略后,设计有意图的内部链接图谱,兼顾 SEO、用户体验与 LLM 可读性。
主要能力:负责简报与长文之间的双向链接、面包屑、主题/项目/作者/社区/来源追踪链接、锚文本意图、孤岛页检查、过度链接与重复意图风险检查。不负责 canonical 与 hreflang 策略、最终 URL 架构、外链放置、隐藏链接、视觉 UI 布局和 schema 实现。
使用方式:先阅读 references/link-graph-rules.md,再读取 url-map.yaml、页面角色、canonical 模型、语言分组和内容模型;识别必需的结构性链接,仅在链接对用户可见且有用时添加来源追踪链接;为每条链接分配 link_type、anchor_intent、user_reason、seo_reason 和 risk;标记孤岛页、无目的的循环链接、不相关的精确匹配锚文本和重复的正文路由;使用 assets/internal-link-graph.template.yaml 生成 internal-link-graph.yaml,并将 schema/head 影响交给 technical-seo-schema-engineer,将渲染导航检查交给 ui-ux-llm-product-architect。
链接规则:每条链接必须有用户理由;简报在有长文时链接到其唯一长文,长文在简报仍为独立新闻面时回链;主题页用摘要组织相关页面,不复制正文;作者与项目链接支持信任和实体理解;面包屑澄清层级而非堆砌关键词;相关链接应稀疏且可辩护;外链权威放置不在范围内。
安全与隐私边界:不推荐隐藏链接、伪装链接、注入页脚、不相关精确匹配锚文本或链接堆砌;不将公开页面链接到管理后台、私有 API、私有分析、原始 IP 日志、预发布 URL、机密文件或未发布草稿;不为增加链接数创建额外公开故事页;不为 SEO 锚文本削弱 UX 或可访问性。
验证:完成前确认每条链接都有源 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。输出包括链接图谱摘要、必需结构链接、可选相关链接、孤岛/过度链接风险,以及给技术 SEO/schema 和 UX 的交接说明。