Communitygithub.com

平台規格與驗證

在發布前確保貼文在所有目標平台上都符合欄位規則、媒體限制與規範,並執行「驗證後發布」流程。

平台規格與驗證 是什麼?

此技能是 WoopSocial 貼文發布流程中的關鍵核心,負責確保貼文在發布前符合所有目標平台的欄位、媒體與規範要求。WoopSocial 採用原子性驗證與發布機制(`POST /posts`),只要有一個目標平台驗證失敗,整則貼文就不會建立,且沒有更新端點(編輯等於刪除後重建)。因此,正確填寫每個平台的必填欄位、遵守媒體規則(例如 Facebook 禁止圖片與影片混用、Pinterest 僅限單一媒體)以及從 `platform-inputs` 解析帳號特定值(如 Pinterest 看板、TikTok 隱私設定)是成功發布的關鍵。技能採用 CHECK 框架(Collect、Hydrate、Enforce、Confirm、Knock)來引導流程,並包含真理宣告(isBrandedContent 等)不可偽造的限制。此技能與各平台格式技能(如 TikTok 照片模式、YouTube 發布與中繼資料)及排程佇列技能不同,專注於跨平台的欄位、媒體與驗證層,而不處理內容創作或時程安排。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/social-media-skills/skills/tree/main/skills/platform-specs-and-validation

在你喜歡的 AI 中提問

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

說明文件

平台規格與驗證 是做什麼的?

跨領域的發布就緒技能 — 讓貼文在每個目標平台上都正確(必填欄位、媒體規則、限制),並執行發布前驗證循環。它是格式技能所指向的關鍵技能。 代理程式對應欄位 + 修正規範違規 + 驗證;WoopSocial 驗證並發布;內容創作和人為判斷決策則保留在其他地方。

觀點:一次就原子性地準備好發布

WoopSocial 原子性地驗證並發布 — POST /posts 同時檢查每個目標,如果有任何一個失敗,就不會建立任何內容。 沒有更新端點,因此發布錯誤的貼文無法修補(編輯 = 刪除後重建)。這使得在發布前把每個目標的欄位都弄對成為關鍵:正確的 postType、每個平台所需的欄位、媒體規則,以及從 platform-inputs 解析的帳號特定值(Pinterest 看板、TikTok 隱私設定)— 然後使用 POST /posts/validate 來捕捉遺漏的部分。這個技能是格式技能來確保貼文真的會通過的地方。

框架:CHECK

(深入說明:references/the-check-framework.md。)

  • C — 收集目標和專案: 列出社交帳號;確認它們在同一個專案中;記下每個平台的欄位集。
  • H — 填充每個平台的必填欄位: 填寫每個目標的必填欄位(FB/IG 的 postType;TikTok 的八個;YouTube 的 title+privacy;Pinterest 的 pinterestBoardId);從 GET /social-accounts/{id}/platform-inputs 解析帳號值。
  • E — 強制執行媒體和內容規則: Facebook 禁止圖片+影片混用;Instagram 限時動態需要媒體;Pinterest 單一媒體;TikTok 的 PHOTO/VIDEO 欄位適用性;在傳播衝突時使用 contentOverride 或分開發布;遵守文字長度限制。
  • C — 確認宣告的真實性: isBrandedContent/isYourBrand/madeForKids 是真實的宣告,而不是驗證的開關 — 永遠不要為了清除錯誤而翻轉它們;這些由人員決定。
  • K — 完成驗證: POST /posts/validate → 修正所有錯誤,檢閱警告 → 建立(原子性)。沒有更新 → 刪除後重建(僅限於 NOT_STARTED 狀態時)。

規格(事實來源 — 每季驗證)

每個平台的 postType 列舉值 + 必填欄位矩陣 + 媒體規則 + platform-inputs 發現端點 + 生命週期事實(原子建立、無更新、傳遞狀態、排程類型): references/woopsocial-publish-spec.md。驗證後建立循環、完整的 ValidationField 代碼表 + CreatePostErrorCode 清單 + 範例:references/validation-reference-and-recipes.md。(即時 OpenAPI 規格 / tools/integrations/woopsocial.md 是事實來源;列舉和限制會變動。)

誠實的範圍(絕不違反)

  • 此技能確保發布就緒性(欄位/媒體/規格正確且已驗證)— 它不撰寫或改善創意內容(格式/內容技能負責)且無法保證表現。
  • WoopSocial 原子性地驗證並發布;一個目標失敗則整篇貼文失敗。 沒有更新 → 刪除後重建(僅限於 NOT_STARTED 狀態時)。
  • 揭露/合規宣告必須保持真實(isBrandedContent/isYourBrand/madeForKids)— 絕不為了通過驗證而翻轉;隱私意圖和揭露真實性由人員決定。
  • 從 platform-inputs 解析帳號值(看板、隱私)— 不要猜測。絕不虛構指標 — 僅限原生分析。(範圍、區別和連結:references/scope-and-connections.md。)

與其兄弟技能的區別(正確路由)

platform-specs-and-validation(此技能) = 跨平台的欄位/媒體/驗證層,使貼文在每個目標上都發布就緒 · 各平台格式技能(tiktok-photo-mode、tiktok-video-publishing、threads-post、youtube-publishing-and-metadata、carousel-writer,…) = 創作一個平台的內容並指向此處進行驗證 · scheduling-and-queue = 時機/節奏,而非正確性 · tools/integrations/woopsocial.md = 此技能在貼文層級應用的共享整合指南。

連接地點

接收自:每個格式技能(已創作的內容和選擇的 postType)和 content-calendar(計劃)。解析使用:GET /social-accounts/{id}/platform-inputs(看板、隱私選項)+ 整合指南。傳遞給:scheduling-and-queue → WoopSocial(在 isValid 後使用 POST /posts),然後使用 webhooks/傳遞狀態進行確認。支援:跨平台重新利用(每個目標的 contentOverride)、分析與報告(原生傳遞讀取)、實驗(有效的變體)。內容創作和真實的宣告保留在格式技能和人員處。

完成定義

每個目標都已收集並確認在一個專案中;每個目標的必填欄位已填充(postType / 隱私 / 看板 / 揭露 / 標題視情況適用),帳號特定值已從 platform-inputs 解析;媒體和內容規則已強制執行(無 Facebook 混用、Instagram 限時動態媒體、單一 Pinterest 媒體、TikTok 欄位適用性),並在傳播衝突時使用 contentOverride 或分開發布;揭露/madeForKids 宣告保持真實(絕不為了通過驗證而翻轉);已執行 POST /posts/validate,在原子性建立前解決所有錯誤並審查警告;編輯透過刪除+重建處理,不虛構任何內容也不承諾表現;正確地與各平台格式技能和 scheduling-and-queue 區分。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

相關技能