修复 HTML 元数据

---

name: fixing-metadata description: "审计和修复 HTML 元数据，包括页面标题、meta 描述、规范 URL、Open Graph 标签、Twitter 卡片、favicon、JSON-LD 结构化数据和 robots 指令。在添加或审查 SEO 和社交元数据时使用。" risk: safe source: community version: 1.0.1 license: MIT

工作流程

1. 识别缺失或不正确元数据的页面（标题、描述、规范链接、OG 标签）
2. 按照以下优先级规则进行审计 — 优先修复关键问题（重复、索引）
3. 确保标题、描述、规范链接和 og:url 彼此一致
4. 在真实 URL 上验证社交卡片渲染是否正确，而非 localhost
5. 保持差异最小化，仅限于元数据范围 — 不要重构无关代码

使用场景

在以下情况下参考这些指南：

• 添加或更改页面标题、描述、规范链接、robots
• 实现 Open Graph 或 Twitter 卡片元数据
• 设置 favicon、应用图标、manifest、theme-color
• 构建共享 SEO 组件或布局元数据默认值
• 添加结构化数据（JSON-LD）
• 更改语言环境、备用语言或规范路由
• 发布新页面、营销页面或可分享链接

按优先级分类的规则

| 优先级 | 类别 | 影响 | |--------|------|------| | 1 | 正确性和重复 | 关键 | | 2 | 标题和描述 | 高 | | 3 | 规范链接和索引 | 高 | | 4 | 社交卡片 | 高 | | 5 | 图标和 manifest | 中 | | 6 | 结构化数据 | 中 | | 7 | 语言环境和备用链接 | 低-中 | | 8 | 工具边界 | 关键 |

快速参考

1. 正确性和重复（关键）

• 每个页面在一个位置定义元数据，避免竞争系统
• 不要输出重复的标题、描述、规范链接或 robots 标签
• 元数据必须是确定性的，不能有随机或不稳定的值
• 转义和清理任何用户生成或动态字符串
• 每个页面必须有安全的标题和描述默认值

2. 标题和描述（高）

• 每个页面必须有标题
• 在整个站点使用一致的标题格式
• 保持标题简短可读，避免堆砌
• 可分享或可搜索的页面应有 meta 描述
• 描述必须是纯文本，不能有 markdown 或引号堆砌

3. 规范链接和索引（高）

• 规范链接必须指向页面的首选 URL
• 仅对私有、重复或非公开页面使用 noindex
• robots meta 必须与实际访问意图匹配
• 预览或暂存页面应尽可能默认设为 noindex
• 分页页面必须有正确的规范链接行为

4. 社交卡片（高）

• 可分享页面必须设置 Open Graph 标题、描述和图片
• Open Graph 和 Twitter 图片必须使用绝对 URL
• 优先使用正确的图片尺寸和稳定的宽高比
• og:url 必须与规范 URL 匹配
• 使用合理的 og:type，通常为 website 或 article
• 适当设置 twitter:card，默认使用 summary_large_image

5. 图标和 manifest（中）

• 至少包含一个跨浏览器兼容的 favicon
• 在相关时包含 apple-touch-icon
• manifest 使用时必须有效且被引用
• 有意设置 theme-color 以避免 UI 外观不匹配
• 图标路径应稳定且可缓存

6. 结构化数据（中）

• 除非明确映射到真实页面内容，否则不要添加 JSON-LD
• JSON-LD 必须有效且反映实际渲染的内容
• 不要编造评分、评论、价格或组织详情
• 除非必要，每页优先使用一个结构化数据块

7. 语言环境和备用链接（低-中）

• 正确设置 html lang 属性
• 存在本地化时设置 og:locale
• 仅在页面确实存在时添加 hreflang 备用链接
• 本地化页面必须按语言环境正确规范化

8. 工具边界（关键）

• 优先最小化更改，不要重构无关代码
• 除非被要求，不要迁移框架或 SEO 库
• 遵循项目现有的元数据模式（Next.js metadata API、react-helmet、手动 head 等）

审查指南

• 优先修复关键问题（重复、规范链接、索引）
• 确保标题、描述、规范链接和 og:url 一致
• 在真实 URL 上验证社交卡片，而非 localhost
• 优先使用稳定、朴素的元数据而非花哨或动态的
• 保持差异最小化，仅限于元数据范围

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停下来寻求澄清。