information-architecture-seo

信息架构 SEO

在 semantic-core-architect 之后，以及内部链接、结构化数据或大模型可读层之前使用此技能。

生成完整的 URL 映射前，请阅读 references/url-architecture.md。

负责范围

• URL 策略；
• 页面分类；
• 页面角色和内容归属；
• 规范网址模型；
• hreflang 分组；
• 索引/不索引策略；
• 支柱页/主题页/新闻页/文章页/博客页/项目页的角色划分；
• 防止重复内容。

不负责范围

• 创建语义核心；
• 最终页面文案；
• 内部链接图的详细信息；
• JSON-LD 实现；
• 渲染后的 UI 设计；
• 外部反向链接。

工作流

1. 阅读语义核心、实体-主题映射、网站约束、语言和内容模型。
2. 为每个聚类/实体/主题确定规范页面角色。
3. 先定义路由模式，再定义单个 URL。
4. 按页面角色设置规范网址策略。
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。

规范网址规则

• 如果页面具有独特的用户/搜索角色且包含可见内容，则可以将自身设为规范网址。
• 简短新闻简报和一篇扩展长文可以同时将自身设为规范网址，前提是简报用于快速呈现新闻，而长文用于持久、深入地解释内容。
• 默认情况下，不要将独立的简报规范化到其长文。
• 除声明的模型之外，不要创建额外的公开故事变体。
• 主题页和支柱页必须进行概述和整理，不得重复文章正文。
• 本地化版本使用 hreflang；它们不会取代规范网址自引用。

多语言规则

• 除非网站设有独立的语言选择器页面，否则默认语言负责 x-default。
• 每个本地化页面都必须声明自己的规范 URL。
• Hreflang 分组只能包含真正的等效页面，不得包含仅松散相关的页面。
• 如果翻译质量未知，请将本地化页面标记为 draft 或 deferred，而非已发布。

安全与隐私边界

• 不要将管理页面、API、私人仪表板、原始分析数据、原始 IP 日志、机密文件或暂存 URL 暴露为可公开索引的页面。
• 对低价值实用页面使用 noindex 或受阻的内部路由；不要依赖隐藏公开导航。
• 不要为了便于抓取而削弱身份验证、访问控制或安全标头。
• 不要将私人源 URL、凭据、令牌、未发布的草稿或内部备注放入 url-map.yaml、站点地图计划或面向公众的大模型内容中。

验证

标记工作完成前，请确认：

• 每个页面都有 URL、页面类型、语言区域、规范网址、索引策略和理由；
• 每个语言版本都有结构合理的 hreflang 分组；
• 每个故事在每种语言中至多有一篇简报和一篇长文；
• 主题页不会重复文章正文；
• 最终链接图的详细信息留给 internal-link-graph-architect；
• 结构化数据实现留给 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。

输出格式

返回：

1. URL 策略摘要。
2. 页面角色表。
3. 规范网址和 hreflang 策略。
4. 重复内容风险。
5. 关于内部链接和技术 SEO/结构化数据的移交说明。