
关于
审计和修复 HTML 元数据,包括页面标题、Meta 描述、规范 URL、Open Graph 标签、Twitter 卡片、Favicon、JSON-LD 结构化数据和 robots 指令
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
工作流程
- 识别缺失或不正确元数据的页面(标题、描述、规范链接、OG 标签)
- 按照以下优先级规则进行审计 — 优先修复关键问题(重复、索引)
- 确保标题、描述、规范链接和 og:url 彼此一致
- 在真实 URL 上验证社交卡片渲染是否正确,而非 localhost
- 保持差异最小化,仅限于元数据范围 — 不要重构无关代码
使用场景
在以下情况下参考这些指南:
- 添加或更改页面标题、描述、规范链接、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
- 优先使用稳定、朴素的元数据而非花哨或动态的
- 保持差异最小化,仅限于元数据范围
限制
- 仅在任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必要的输入、权限、安全边界或成功标准,请停下来寻求澄清。
兼容工具
Claude CodeCursor
标签
前端开发