SuperAPI AI 工具集

information-architecture-seo

营销与增长

查看项目

更新于 10-16 02:25

技能介绍

Information Architecture SEO 是一个信息架构技能,用于把语义核心(semantic core)转化为可抓取、对 LLM 友好的信息架构。它被定位在 semantic-core-architect 之后、内部链接(internal linking)、schema 或 LLM 可读层之前使用。在产出完整 URL 映射之前,应先阅读 references/url-architecture.md。

一、用途与职责范围 该技能负责(Owns):URL 策略;页面分类体系(page taxonomy);页面角色与内容归属;canonical 模型;hreflang 分组;index/noindex 策略;pillar/topic/news/article/blog/project 角色分离;重复内容预防。

该技能不负责(Does Not Own):语义核心创建;最终页面文案;内部链接图细节;JSON-LD 实现;渲染后的 UI 设计;外部反向链接。

二、工作流程

  1. 读取语义核心、实体-主题映射、站点约束、语言与内容模型。
  2. 为每个聚类/实体/主题确定规范的页面角色。
  3. 先定义路由模式(route patterns),再定义单个 URL。
  4. 按页面角色设置 canonical 策略。
  5. 为本地化对应页面定义 hreflang 分组。
  6. 标记页面状态:planned、draft、published、noindex 或 deferred。
  7. 记录重复内容风险与归属边界。
  8. 使用 assets/url-map.template.yaml 产出 url-map.yaml。
  9. 交接给 internal-link-graph-architect 与 technical-seo-schema-engineer。

三、Canonical 规则

  • 当页面具有独立的用户/搜索角色且内容可见时,可以自引用 canonical(self-canonical)。
  • 短新闻简报与一篇扩展长文可以同时自引用 canonical,前提是简报作为快速新闻面、长文作为持久解释面。
  • 默认情况下,不要将独立简报 canonical 到其长文。
  • 不要创建超出已声明模型的额外公开故事变体。
  • 主题页与 pillar 页必须做汇总与组织,不得复制文章正文。
  • 本地化替代页使用 hreflang,不替代 canonical 自引用。

四、多语言规则

  • 默认语言拥有 x-default,除非站点有单独的语言选择页。
  • 每个本地化页面必须声明自己的 canonical URL。
  • Hreflang 分组只能包含真正的对应页面,而非松散相关页面。
  • 若翻译质量未知,将本地化页面标记为 draft 或 deferred,而非 published。

五、安全与隐私边界

  • 不得将 admin、API、私有仪表盘、原始分析数据、原始 IP 日志、密钥文件或 staging URL 暴露为公开可索引页面。
  • 对低价值工具页使用 noindex 或受控内部路由;不要依赖公开导航隐藏。
  • 不得为可抓取性削弱认证、访问控制或安全响应头。
  • 不得将私有源 URL、凭据、令牌、未发布草稿或内部备注放入 url-map.yaml、sitemap 计划或面向 LLM 的公开产物中。

六、验证 在标记工作完成前:每个页面都有 URL、页面类型、locale、canonical、index 策略与理由;每个语言替代页都有连贯的 hreflang 分组;每个故事每种语言至多一个简报与一个长文;主题页不复制文章正文;最终链接图细节留给 internal-link-graph-architect;schema 实现留给 technical-seo-schema-engineer。

技能编辑使用以下命令验证: python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/information-architecture-seo python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL

前向测试位于 evals.json。

七、输出形态 返回:URL 策略摘要;页面角色表;canonical 与 hreflang 策略;重复内容风险;面向内部链接与技术 SEO/schema 的交接说明。

八、适用场景与限制 适用于需要规划 URL 结构、页面分类、canonical/hreflang 策略、index 策略与重复内容治理的 SEO 信息架构工作,尤其适合多语言站点与需要 LLM 可读层的项目。限制在于:它不创建语义核心、不撰写最终文案、不实现内部链接图与 JSON-LD,也不处理外部反向链接;这些需交由其他技能完成。