page-metadata

SEO 页面内优化：页面元数据

负责统筹完整的元数据生命周期，包括范围、路由、实施、验证和交付；各专项技能负责各自的文案撰写和标签规则。

调用时：首次使用时，简要说明工作范围以及需要哪些专项技能。随后依据当前生产环境证据和实际事实来源开展工作，而不是制作一份脱离实际的副本清单。

职责归属与边界

事项	负责人
生命周期、页面清单、实施、验证、交付	page-metadata
<title> 的撰写与审核	title-tag
Meta 描述的撰写与审核	meta-description
H1-H6 的撰写与层级结构	heading-structure
Open Graph	open-graph
X/Twitter Cards	twitter-cards
规范 URL	canonical-tag
本地化	localization-strategy、translation
发布后的查询与 CTR 观察	google-search-console

此技能可以检查 H1 和正文内容是否覆盖相关主题，以确认元数据中的承诺得到兑现。不得重写 H1-H6；此类工作应交由 heading-structure。可以报告关键词蚕食问题，但不得合并页面、更改页面角色、删除 URL 或重新分配目标关键词。

必需的输入与证据

如存在根目录下的 contextus.md，请先阅读，并仅加载相关模块。否则使用项目文档和经过核实的产品事实。确认以下内容：

1. 目标网站、区域设置、环境和发布范围。
2. 根据生产环境中的导航、页脚、上下文链接、索引页或中心页、robots.txt、sitemap、生产 URL 和应用路由，建立页面清单。sitemap 是一项证据，但不保证清单完整。对于规模很大的自动生成页面系列，应检查模板和代表性示例，而不是逐一列举所有 URL。
3. 页面类型、独特用途、主要搜索意图、目标查询证据、受众和页面特定事实。
4. 当前生产环境输出：标题、描述、H1、规范 URL、robots、hreflang、OG、Twitter Cards、HTTP 状态和服务器返回的 HTML。
5. 实际维护来源：框架元数据 API、布局模板、路由模块、静态 HTML、JSON/YAML、CMS 字段、服务器注入或代理层。

切勿仅根据源代码推断当前生产环境中的元数据。部署环境和生产环境可能存在差异，且方向不定。

生命周期

1. 发现并分类页面

• 建立 URL 到页面类型的映射，并为重复页面系列选取有代表性的样本。
• 找出缺失、重复、过时、继承而来、回退或跨区域设置的元数据。
• 撰写标题前，检查模板自动生成的品牌后缀，避免重复添加。
• 标记旧品牌名称、母产品相关表述、过时功能或从同系列其他页面复制的说法。

2. 明确意图和页面身份

• 确认页面自身能够承诺并证明什么。
• 使用经过核实的产品事实和当前页面内容；不得编造差异化优势。
• 应用 替换测试：如果某个标题或描述可以原样用于同系列其他页面，就说明它缺少页面特定信息。
• 报告潜在的关键词蚕食问题，并列出受影响的 URL、重叠意图和证据。报告到此为止，不再采取后续操作。

3. 分派专项工作

• 标题决策交由 title-tag，描述交由 meta-description。
• 仅当标题确实需要修改时才使用 heading-structure；否则检查语义是否一致。
• 社交元数据交由 open-graph 和 twitter-cards。社交文案可以不同于 SEO 文案，但页面身份和声明必须保持一致。
• 视情况使用 canonical-tag、localization-strategy 和 translation。

4. 按市场进行本地化

• 研究每种语言区域的搜索查询语言和意图；不要翻译并截断源元数据。
• 如果存在术语来源，请有意保留产品和品牌术语。
• 确认每种语言区域的 URL、canonical、hreflang 集合和 og:locale 之间的关系。
• 将缺失或实质上不等效的语言区域页面视为实现问题，而不是伪造一致性。

5. 在唯一真实来源中实现

• 修改规范代码或 CMS 字段，而不是生成的输出。
• 除非单独的迁移任务需要更改，否则保留 URL 和页面身份。
• 考虑布局继承、路由优先级、模板插值、CMS 回退机制和自动添加的品牌后缀。
• 确保 title、description、社交元数据、canonical、robots 和 hreflang 内部一致，但不要强行要求字符串相同。

6. 发布前验证

运行相关的 lint、类型检查、测试和生产构建。然后在可行时启动或预览构建后的应用，并检查代表性 URL 和语言区域的初始服务器响应 HTML。如果爬虫可能收到不同的 HTML，仅检查浏览器 DOM 快照是不够的。

检查：

• 恰好有一个有效的 title 和一个预期的 description；
• 输出不为空、不是占位内容、没有重复，也没有重复添加后缀；
• title 和 H1 表达相同的页面意图，但措辞不必相同；
• H2 和正文内容能够支撑元数据所作的承诺；
• canonical、robots、hreflang、OG 和 Twitter 标签均指向预期的绝对 URL；
• HTML 转义、语言区域输出、图片和状态码均正确。

7. 验证生产环境并进行观察

• 部署后使用原始响应 HTML 重新检查具有代表性的生产 URL。
• 在可用时使用平台预览/调试工具检查社交标签；缓存的预览可能需要刷新。
• 重新抓取后，使用 google-search-console 观察查询组合、展示次数、标题/摘要表现和 CTR。不要承诺排名或 CTR 会提升。

其他技术元数据

• robots 控制页面级索引/摘要行为；robots.txt 控制抓取行为。使用 indexing 和 robots-txt 制定策略。
• viewport 通常使用 width=device-width, initial-scale=1。
• 在文档 head 的靠前位置声明 UTF-8。
• Hreflang 注释必须使用有效的语言或语言-地区代码，包含自身及相互引用，并将每种语言区域与其各自的 canonical URL 对应起来。应统一使用 HTML、sitemap 或 HTTP 标头。

交付内容

提供范围和证据、受影响的 URL 或页面系列、其实际维护来源、适用时的修改前后元数据、未解决的阻碍因素、任何关键词蚕食报告、构建/HTML/语言区域/生产环境验证结果，以及发布后的观察计划。

主要参考资料

• Google：标题链接
• Google：摘要和 meta 描述
• Google：本地化版本

相关技能

• title-tag、meta-description、heading-structure
• open-graph、twitter-cards、canonical-tag
• localization-strategy、translation
• indexing、robots-txt、google-search-console