fixing-metadata
交付正确、完整的元数据。
如何使用
-
/fixing-metadata在此对话中,对所有元数据相关工作应用这些约束。 -
/fixing-metadata <file>根据以下所有规则审查文件,并报告:- 违规行为(引用确切的代码行或片段)
- 为何重要(一句简短的说明)
- 具体的修复方案(代码级别的建议)
除非明确要求,否则不要引入新的框架或 SEO 库。优先采用最小变更。
何时应用
在以下情况参考这些指南:
- 添加或更改页面标题、描述、规范链接、robots
- 实现 Open Graph 或 Twitter 卡片元数据
- 设置网站图标、应用图标、manifest、主题色
- 构建共享 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(中)
- 至少包含一个跨浏览器有效的网站图标
- 在适当情况下包含 apple-touch-icon
- manifest 必须有效,并且在被使用时正确引用
- 有意识地设置 theme-color,以避免 UI 界面颜色不匹配
- 图标路径应保持稳定且可缓存
6. 结构化数据(中)
- 除非 JSON-LD 明确映射到页面实际内容,否则不要添加
- JSON-LD 必须有效,并反映实际渲染的内容
- 不要编造评分、评论、价格或组织详细信息
- 除非必要,每个页面优先使用一个结构化数据块
7. 区域设置与替代语言(低-中)
- 正确设置 html lang 属性
- 当存在本地化内容时设置 og:locale
- 仅当页面真实存在时添加 hreflang 替代链接
- 本地化页面必须按区域设置正确进行规范化
8. 工具边界(严重)
- 优先最小化变更,不要重构无关代码
- 除非要求,不要迁移框架或 SEO 库
- 遵循项目现有的元数据模式(Next.js 元数据 API、react-helmet、手动 head 等)
审查指南
- 优先修复严重问题(重复、规范链接、索引)
- 确保标题、描述、规范链接和 og:url 一致
- 在真实 URL 上验证社交卡片,而非 localhost
- 优先使用稳定、规范的元数据,而非花哨或动态的
- 保持差异最小,仅限元数据相关的修改