新增或修复页面 HTML 元数据时，用优先级规则审计并修正…

适用于添加或修改页面 title、description、canonical、Open Graph/Twitter 卡片、favicon、manifest、JSON-LD、robots 指令，或发布需要正确元数据的新页面时。

适用场景

解决思路

1. 按优先级审查和修复：1 正确性与重复（critical）；2 title 和 description（high）；3 canonical 和索引（high）；4 社交卡片（high）；5 图标和 manifest（medium）；6 结构化数据（medium）；7 locale 和 alternates（low-medium）；8 工具边界（critical）。
2. 识别缺少或不正确的元数据页面（titles、descriptions、canonical、OG 标签）。
3. 按下方优先级规则审计，先修复关键问题（重复、索引）。
4. 确保 title、description、canonical 和 og:url 彼此一致。
5. 在真实 URL 上验证社交卡片能正确渲染，而不是 localhost。
6. 保持 diff 最小且仅限元数据；不要重构无关代码。
7. 每个页面只在一个地方定义元数据，避免竞争系统。
8. 不要输出重复的 title、description、canonical 或 robots 标签。
9. 元数据必须是确定性的，不要随机或不稳定值。
10. 转义并清理任何用户生成或动态字符串。
11. 每个页面必须有安全的 title 和 description 默认值。
12. 每个页面必须有 title。
13. 全站使用一致的 title 格式。
14. 保持 title 简短可读，避免堆砌关键词。
15. 可分享或可搜索页面应有 meta description。
16. description 必须是纯文本，不要 markdown 或过多引号。
17. canonical 必须指向页面的首选 URL。
18. 仅对私有、重复或非公开页面使用 noindex。
19. robots meta 必须匹配实际访问意图。
20. 预览或 staging 页面在可能时应默认 noindex。
21. 分页页面必须具有正确的 canonical 行为。
22. 可分享页面必须设置 Open Graph title、description 和 image。
23. Open Graph 和 Twitter 图片必须使用绝对 URL。
24. 优先使用正确图片尺寸和稳定宽高比。
25. og:url 必须匹配 canonical URL。
26. 使用合理的 og:type，通常是 website 或 article。
27. 适当设置 twitter:card，默认 summary_large_image。
28. 至少包含一个跨浏览器可用的 favicon。
29. 相关时包含 apple-touch-icon。
30. 使用 manifest 时必须有效且被引用。
31. 有意设置 theme-color，避免 UI chrome 不匹配。
32. 图标路径应稳定且可缓存。
33. 除非 JSON-LD 明确映射真实页面内容，否则不要添加。
34. JSON-LD 必须有效，并反映实际渲染内容。
35. 不要编造评分、评论、价格或组织详情。
36. 除非有需要，每个页面优先只放一个结构化数据块。
37. 正确设置 html lang 属性。
38. 存在本地化时设置 og:locale。
39. 仅当页面真实存在时才添加 hreflang alternates。
40. 本地化页面必须按 locale 正确 canonicalize。
41. 优先最小改动，不要重构无关代码。
42. 除非被要求，不要迁移框架或 SEO 库。
43. 遵循项目现有元数据模式（Next.js metadata API、react-helmet、manual head 等）。
44. 先修复关键问题（重复、canonical、索引）。
45. 确保 title、description、canonical 和 og:url 一致。
46. 在真实 URL 上验证社交卡片，而不是 localhost。
47. 优先使用稳定、朴素的元数据，而不是聪明或动态的元数据。
48. 保持 diff 最小且仅限元数据。

适用边界 · 注意事项

• 当任务需要重构框架、迁移 SEO 库或修改无关代码时，不应使用本技能。
• 当页面没有真实内容支撑时，不应添加 JSON-LD，也不要编造评分、评论、价格或组织信息。
• 如果只能在 localhost 验证且无法提供真实 URL，社交卡片渲染验证不可靠，应延迟确认。