修正元資料
交付正確且完整的元資料。
如何使用
-
/fixing-metadata將這些約束套用至目前對話中的任何元資料工作。 -
/fixing-metadata <file>針對所有規則審查該檔案,並回報:- 違規(引用確切的行或片段)
- 為何重要(一句簡短的說明)
- 具體修正(程式碼層級的建議)
除非明確要求,否則不要引入新的框架或SEO函式庫。偏好最小改動。
何時套用
在以下情況參考這些準則:
- 新增或變更頁面標題、描述、標準網址、robots
- 實作 Open Graph 或 Twitter 卡片元資料
- 設定 favicon、應用程式圖示、manifest、theme-color
- 建構共用 SEO 元件或佈局元資料預設值
- 新增結構化資料 (JSON-LD)
- 變更語言代碼、替代語言或標準路由
- 上線新頁面、行銷頁面或可分享連結
依優先順序的規則類別
| 優先級 | 類別 | 影響 |
|---|---|---|
| 1 | 正確性與重複 | 嚴重 |
| 2 | 標題與描述 | 高 |
| 3 | 標準網址與索引 | 高 |
| 4 | 社交卡片 | 高 |
| 5 | 圖示與清單 | 中 |
| 6 | 結構化資料 | 中 |
| 7 | 語言代碼與替代語言 | 低-中 |
| 8 | 工具邊界 | 嚴重 |
快速參考
1. 正確性與重複(嚴重)
- 每頁只在一處定義元資料,避免競爭系統
- 不要發出重複的 title、description、canonical 或 robots 標籤
- 元資料必須是確定性的,不能有隨機或不穩定的值
- 對使用者產生或動態的字串進行跳脫與清理
- 每個頁面都必須有 title 和 description 的安全預設值
2. 標題與描述(高)
- 每個頁面都必須有 title
- 在整個網站中使用一致的 title 格式
- 保持標題簡短可讀,避免關鍵字堆砌
- 可分享或可搜尋的頁面應有 meta description
- 描述必須是純文字,不能有 markdown 或引號垃圾
3. 標準網址與索引(高)
- canonical 必須指向該頁面的偏好 URL
- 僅對私人、重複或非公開頁面使用 noindex
- robots meta 必須符合實際存取意圖
- 預覽或暫存頁面在可能的情況下應預設為 noindex
- 分頁頁面必須有正確的 canonical 行為
4. 社交卡片(高)
- 可分享頁面必須設定 Open Graph 的 title、description 和 image
- Open Graph 和 Twitter 圖片必須使用絕對 URL
- 偏好正確的圖片尺寸和穩定的長寬比
- og:url 必須與 canonical URL 相符
- 使用合理的 og:type,通常為 website 或 article
- 適當地設定 twitter:card,預設為 summary_large_image
5. 圖示與清單(中)
- 至少包含一個能在各瀏覽器運作的 favicon
- 在相關時包含 apple-touch-icon
- manifest 在使用時必須有效且被引用
- 有意地設定 theme-color,避免 UI chrome 不匹配
- 圖示路徑應穩定且可快取
6. 結構化資料(中)
- 除非清楚對應至實際頁面內容,否則不要新增 JSON-LD
- JSON-LD 必須有效並反映實際渲染的內容
- 不要虛構評分、評論、價格或組織詳細資訊
- 除非必要,否則每頁偏好一個結構化資料區塊
7. 語言代碼與替代語言(低-中)
- 正確設定 html lang 屬性
- 當存在在地化時設定 og:locale
- 僅在頁面真正存在時才新增 hreflang 替代
- 在地化頁面必須依語言代碼正確標準化
8. 工具邊界(嚴重)
- 偏好最小改動,不要重構不相關的程式碼
- 除非要求,否則不要遷移框架或 SEO 函式庫
- 遵循專案現有的元資料模式(Next.js 元資料 API、react-helmet、手動 head 等)
審查指引
- 先修正嚴重問題(重複、標準網址、索引)
- 確保 title、description、canonical 和 og:url 一致
- 在真實 URL(非 localhost)上驗證社交卡片
- 偏好穩定且樸實的元資料,勝過花俏或動態的
- 保持改動最小且限於元資料層面