Community程式設計與開發github.com

Schema.org 結構化資料實作 — 完整工作流程技能

編碼技能。使用者想要在整個網站上實作 schema.org 結構化資料。涵蓋從頁面類型分析到開發人員就緒的工單建立(JIRA、Wrike 或其他專案管理工具)的完整工作流程。觸發關鍵詞包括任何提及「schema.org」、「結構化資料」、「豐富結果」、「JSON-LD」、「JIRA schema 工單」、「Wrike schema 任務」,或要求分析網站頁面以進行 SEO 標記。當使用者參考 schema 實作方法論時也適用。

Schema.org 結構化資料實作 — 完整工作流程技能 是什麼?

此技能提供了一個端到端的方法論,用於分析網站、設計 schema.org 標記,並產出開發人員可直接使用的工單。它已透過在多語言、多區域網站上實作結構化資料的真實專案中反覆打磨而成。該方法論與客戶無關,適用於任何以全面的 schema.org 覆蓋率為目標,並透過專案管理工具(如 JIRA、Wrike 或類似工具)進行開發交接的網站。技能定義了六個連續的交付階段:從第 0 階段的設定與工具評估,到第 6 階段的影響衡量,涵蓋頁面類型發現、HTML 分析、schema 設計、工單撰寫、部署後驗證等步驟。它支援瀏覽器輔助分析以達到最高效率,但也提供了無法使用瀏覽器時的替代手動工作流程。參考文件按階段組織,包含詳細規則和常見決策,確保跨工單的一致性和與 Google 最新指引的合規性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rebelytics/schema-implementation/tree/HEAD

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Schema.org 結構化資料實作 — 完整工作流程技能 是做什麼的?

此技能提供了一個端到端的方法論,用於分析網站、設計 schema.org 標記,並產出開發人員可直接使用的工單。它已透過在多語言、多區域網站上實作結構化資料的真實專案中反覆打磨而成。

該方法論與客戶無關。適用於任何以全面的 schema.org 覆蓋率為目標,並透過專案管理工具(JIRA、Wrike 或類似工具)進行開發交接的網站。

授權條款: 此技能根據 Creative Commons Attribution 4.0 International (CC BY 4.0) 授權釋出。您可自由分享及改編此技能用於任何用途,前提是您必須適當註明原作者。

相關稽核: 此技能的第 5 階段會根據第 2 階段設計的規格驗證實際輸出內容。當任務改為驗證跨語言環境的已回報修復(如「所有語言均已修復」、「已部署到所有環境」)時,請執行 JSON-LD 驗證稽核,並採用此技能未涵蓋的驗證規範:快取清除閘門、從 Sitemap 索引/即時 hreflang 集合進行族群列舉,以及正對照組。麵包屑的稽核環節屬於麵包屑導航稽核;此技能負責其工單環節。


此技能如何運作

這是一個專案型技能,對於大多數網站,通常可在 1-3 小時內,分 1-2 個階段完成。具有許多頁面類型的複雜多語言網站可能需要更長時間。技能定義了五個連續的交付階段:第 0 階段(設定)、第 1 階段(探索)、第 2 階段(Schema 設計)、第 3 階段(工單建立)和第 4 階段(重新產生與交付)——接著是兩個部署後階段,在開發人員發佈後執行:第 5 階段(部署後驗證)和第 6 階段(衡量影響)。Claude 應識別使用者處於哪個階段並引導他們完成。

使用者提供: 專案背景、對分析和工單草稿的回饋、專案特定規則、解決未決問題。 Claude 提供: 頁面類型探索、HTML 分析、schema 設計、工單草稿(母工單 + 子工單)以及最終重新產生的一組工單。

術語說明: 此技能使用「工單」作為開發人員交付物的通用術語。實際格式取決於在第 0 階段選擇的專案管理平台(JIRA 工單、Wrike 任務等)。


參考檔案 — 按需載入

第 1 到第 6 階段位於參考檔案中,每個階段一個檔案。每個指標都指定了其觸發條件。這些載入是強制步驟:當某個階段開始時,請先載入其檔案再進行工作——切勿從此核心檔案中即興創作出一個階段。如果您發現某個階段在未載入其檔案的情況下被處理,請指出此情況,載入該檔案,並根據該檔案重新檢查迄今已完成的工作。

  • references/discovery.md — 第 1 階段:頁面類型目錄、分類、Google 指引檢查、每種頁面類型分析(所有三種格式的現有 schema、條件式 schema 分類、語言環境交付)、儲存真實資料、整合、分類。在建立頁面類型目錄及分析任何頁面類型的 HTML 之前載入。
  • references/schema-design.md — 第 2 階段,第 2.1 至 2.7 節:全域與頁面特定 schema、@id 交叉引用、棄用與移除、格式遷移處置、屬性選擇規則、多語言屬性值、驗證假設、專案規則。在為任何頁面類型選擇 schema 類型或屬性之前載入。
  • references/ticket-writing.md — 第 3 階段:起飛前檢查、工單範本、子代理指南、編號的工單撰寫規則(1–46)、母工單、交付前檢查清單、回饋工作流程以及常見 Schema 決策(§3.7)。在草擬、修改或檢查任何工單之前、在向子代理簡報工單相關事宜之前,以及在設計中遇到 §3.7 的決策時載入。
  • references/delivery.md — 第 4 階段:重新產生計畫、平台特定格式化(Wrike、JIRA、富文本編輯器、WAF 保護工具)、交付格式決策樹、編輯審查、跨工單一致性檢查、打包、Wrike XLS + HTML 貼上。在最終重新產生以及格式化工單以適應目標工具之前載入。
  • references/post-deployment-verification.md — 第 5 階段:完整族群掃描觸發條件、第 5 階段起飛前檢查清單、跨語言驗證與擷取技術、四種發現類別與報告架構、跟進評論、URL 與原始值驗證、GSC 錯誤調節與診斷、單次擷取的錯誤綠色訊號、來自爬取匯出的覆蓋率稽核。在驗證任何已部署的 schema 之前、在確認工單完成之前、在回覆客戶回報的差異之前,以及在診斷 Search Console 結構化資料錯誤之前載入。
  • references/measuring-impact.md — 第 6 階段:搜尋外觀細分、期望陳述、可衡量管道、資料保留。當客戶詢問結構化資料達成了什麼、在提取任何影響數據之前載入。

章節編號(§1.2、§5.4)和規則編號(規則 35、反模式 21)在所有檔案中均保持一致,因此交叉引用可透過此對應關係解析。


第 0 階段:設定與工具

目標: 評估可用的工具與存取權限,設定最高效率的工作流程,並在開始內容工作前收集專案層級偏好。

0.1 評估可用工具

在任何分析工作開始前,請確定有哪些可用功能:

  • 瀏覽器存取(例如,Chrome 擴充功能中的 Claude、Cowork 瀏覽器工具)— 使 Claude 能夠直接導覽頁面、擷取渲染後的 HTML、提取數據並自主驗證事實。這是最有效率的工作流程。
  • 網路搜尋 — 使 Claude 能夠在沒有瀏覽器存取的情況下,繪製網站結構圖、尋找 Sitemap 並探索頁面類型。
  • 檔案系統存取 — 支援增量儲存分析文件和工單草稿。
  • 直接網站存取 — 某些網站會封鎖自動化存取(403 錯誤)。如果網路擷取失敗,瀏覽器存取或手動 HTML 上傳可作為備用方案。

0.2 引導使用者使用瀏覽器存取

瀏覽器輔助分析是此技能的主要推薦工作流程。它使 Claude 能夠:

  • 自主探索並繪製頁面類型地圖
  • 從任何頁面擷取渲染後的 HTML,無需手動複製貼上
  • 在幾分鐘內提取偵測訊號、數據來源和範本結構
  • 在撰寫工單前驗證事實(URL 模式、語言變體、欄位可用性)

如果尚未提供瀏覽器存取權限,請說明其優點並引導使用者完成設定。使用者的角色將從「HTML 收集者」(繁瑣、低價值)轉變為「審查者與決策者」(高價值,這是其領域專業知識發揮作用的地方)。

如果無法使用瀏覽器存取或網站完全封鎖自動化瀏覽,則依賴第 1.2 節所述的手動工作流程。

成本意識: 瀏覽器存取能進行最徹底的分析,但在 token 使用上顯著更昂貴 — Chrome 工具呼叫會回傳龐大的負載,隨著對話增長,成本會二次方地增加。將瀏覽器工作流程保留在初始探索和驗證階段,這些階段中即時頁面檢查能增加真正的價值。對於頁面類型清單已確立的任務(例如,根據完成的稽核撰寫工單),非瀏覽器工作流程同樣有效且便宜得多。使用瀏覽器時,偏好使用針對性呼叫(用於精準提取的 get_page_text、find、javascript_tool)而非重量級呼叫(用於完整 DOM 的 read_page、用於完整流量的 read_network_requests)。

0.3 收集專案偏好

在開始內容工作前,詢問使用者:

  1. 專案管理平台 — 「這些工單將在哪個系統中建立?(JIRA、Wrike、Asana 等)」這決定了術語(工單 vs 任務 vs 項目)、格式化限制(例如,Wrike 無法在清單項目內渲染巢狀程式碼區塊 — 請參閱 references/delivery.md 中的 §4.4 平台特定格式化檢查),以及交付檔案的命名慣例。
  2. 工單結構 — 「您的組織是否有開發人員任務的既定工單結構或範本?如果是,請分享範本或工單建立指南。我會調整 schema 工單以符合您團隊的慣例。」如果沒有範本,則使用此技能的預設結構。
  3. 問候語與語氣 — 例如,「Hi team,」搭配同儕語氣,或正式語氣。
  4. 專案特定規則 — 隱私限制、術語、品牌規則等(這些也可以在第 2 階段期間收集)。

第 1 階段:探索與頁面類型目錄

目標: 建立網站上所有頁面類型的完整清單,包含偵測訊號、現有 schema 覆蓋率以及用於工單程式碼範例的儲存真實數據。

在開始此階段前載入 references/discovery.md。 它包含整個階段:

  • 1.1 收集頁面類型清單
  • 1.1b 優先級評估 / 分類
  • 1.1c 驗證 Google 當前指引
  • 1.2 分析每種頁面類型
  • 1.3 儲存用於工單程式碼範例的真實數據
  • 1.4 記錄發現
  • 1.5 識別整合機會
  • 1.6 分類每種頁面類型

第 2 階段:Schema 設計

目標: 決定為每種頁面類型使用哪些 schema 類型和屬性,以及 schema 在整個網站中如何相互關聯。

在選擇 schema 類型或屬性前載入 references/schema-design.md。 它包含第 2.1 至 2.7 節:

  • 2.1 設計全域/共享 Schema
  • 2.2 設計頁面特定 Schema
  • 2.3 設計交叉引用
  • 2.4 棄用與移除
  • 2.4b 格式遷移工單 — 現有格式的處置
  • 2.5 套用屬性選擇規則
  • 2.5b 多語言屬性值
  • 2.6 在最終確定前驗證假設
  • 2.7 專案特定規則

§2.8 保留在此核心檔案中,因為每個工單和每次驗證都會套用它:

2.8 通用技術要求

這些要求適用於每個專案:

  • Schema 必須在伺服器端渲染 — 存在於伺服器回傳的初始 HTML 中,而非由 JavaScript 動態注入。這是最佳 SEO 實務,而非專案特定偏好。
  • JSON-LD 格式 — 始終在 <head> 區段中以 <script type="application/ld+json"> 實作。
  • 獨立的 script 標籤 — 每種 schema 類型都有自己的 <script> 標籤。
  • @context 格式 — 始終使用 https://schema.org(無尾部斜線)。在所有工單中一致地強制執行此規則。
  • 透過真正的 JSON 序列化器輸出 — 絕不通過字串串接/CMS 值的範本化來手動組裝 JSON-LD。手動構建的 JSON-LD 容易出現一整個類別的損壞問題,範圍比未跳脫字元更廣泛:插入值中未跳脫的引號、智慧/彎引號替換(在應為直 " 的地方出現 U+201C/U+201D/U+201E),以及結構性錯誤,例如多餘或重複的括號(例如,@id 值被多餘的一組括號包住)。序列化器能消除整個類別;僅靠跳脫規則無法做到。
  • 解碼文字值中的 HTML 實體 — 文字屬性是承載解碼後的字元('、&),絕非 CMS 欄位或頁面原始碼中儲存的 HTML 實體(&#039;、&amp;)。當來源欄位包含編碼文字時,範本應在序列化前對其進行解碼。
  • 日期使用 ISO 8601,日期時間包含時區偏移 — 每個日期和日期時間屬性(datePublished、dateModified、startDate、validFrom……)都使用 ISO 8601;日期時間需攜帶其偏移量(YYYY-MM-DDThh:mm:ss+hh:mm),絕不使用單純的本地時間或從頁面複製的顯示格式。

第 3 階段:工單建立

目標: 產出開發人員可立即使用的工單 — 一個用於共享 schema 的母工單,以及每個頁面類型(或整合後的群組)一個子工單。

在草擬、修改或檢查任何工單前載入 references/ticket-writing.md。 它包含整個階段:

  • 3.1 起飛前檢查
  • 3.2 工單結構範本
  • 3.2b 子代理使用指南
  • 3.3 工單撰寫規則
  • 3.4 撰寫母工單
  • 3.5 交付前檢查清單
  • 3.6 回饋與迭代流程
  • 3.7 常見 Schema 決策

第 4 階段:最終重新產生與交付

目標: 在一次執行中重新產生所有工單,套用所有累積的規則、決策和修正,以確保跨工單一致性。

在進行最終重新產生之前載入 references/delivery.md。 它包含整個階段:

  • 4.1 建立重新產生計畫
  • 4.2 先解決所有未決問題
  • 4.3 按順序重新產生
  • 4.4 平台特定格式化檢查
  • 交付格式決策樹
  • 4.5 編輯審查
  • 4.6 跨工單一致性檢查
  • 4.7 打包以進行交付
  • 4.8 Wrike 交付 — XLS 骨架 + HTML 貼上

第 5 階段:部署後驗證

目標: 在開發人員部署 schema 後,確認實際輸出符合規格 — 特別注意多語言覆蓋率和數值型別的正確性。

在驗證已部署的 schema、確認工單完成或診斷 Search Console 錯誤之前載入 references/post-deployment-verification.md。 它包含整個階段:

  • 階段前言 — 範圍說明(已回報修復的驗證應交由 JSON-LD 驗證稽核處理)、完整族群掃描的兩種觸發條件,以及全站工單範本清單
  • 第 5 階段起飛前檢查清單(在發送報告前)
  • 5.1 跨語言驗證模式
  • 5.2 稽核發現類別
  • 5.3 何時重新開啟規格
  • 5.4 URL 驗證 — 發佈前程序
  • 5.5 原始值驗證 — 鏡像稽核不足夠
  • 5.6 協調 GSC 錯誤計數與即時爬取
  • 5.7 動態渲染欄位的單次擷取錯誤綠色訊號
  • 5.8 診斷跨同頁面類型 URL 的 GSC「無法解析的結構化資料 / 錯誤的數值型別」
  • 5.9 來自爬取匯出的覆蓋率稽核

第 6 階段:影

…

[已截斷以利翻譯]

相關技能