プラットフォーム仕様とバリデーション は何をしますか?
クロスカッティングな公開準備スキル — すべてのターゲットプラットフォームで投稿を正しく(必須フィールド、メディアルール、制限)し、バリデーション・ビフォア・パブリッシュループを実行します。これはフォーマットスキルが参照する要です。エージェントはフィールドのマッピング、仕様違反の修正、バリデーションを行います。WoopSocialがバリデーションと公開を実行します。コンテンツの作成や人間による判断は別の場所に委ねられます。
視点: 初回でアトミックに公開可能に
WoopSocialはアトミックにバリデーションと公開を行います — POST /posts はすべてのターゲットを同時にチェックし、1つでも失敗すると何も作成されません。更新エンドポイントは存在しないため、間違って公開された投稿を修正することはできません(編集 = 削除して再作成)。したがって、公開前にすべてのターゲットのフィールドを正しく設定することがすべてです。正しい postType、プラットフォームごとの必須フィールド、メディアルール、そして platform-inputs から解決されたアカウント固有の値(Pinterestボード、TikTokプライバシー)を設定し、その後 POST /posts/validate で残った問題を検出します。このスキルは、フォーマットスキルが実際に公開が通ることを確認するために参照する場所です。
フレームワーク: CHECK
(詳細: references/the-check-framework.md)
- C — ターゲットとプロジェクトを収集する: ソーシャルアカウントをリストアップし、それらが同じプロジェクトに属していることを確認し、各プラットフォームのフィールドセットを把握します。
- H — プラットフォームごとの必須フィールドを補完する: 各ターゲットの必須フィールド(FB/IG
postType、TikTokの8つ、YouTubetitle+privacy、PinterestpinterestBoardId)を埋め、GET /social-accounts/{id}/platform-inputsからアカウント値を解決します。 - E — メディアとコンテンツのルールを適用する: FBは画像と動画の混在禁止、IGストーリーはメディア必須、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はアトミックにバリデーションと公開を行います。1つのターゲットが失敗すると投稿全体が失敗します。**更新なし → 削除して再作成(
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 など) = 1つのプラットフォームのコンテンツを作成し、バリデーションのためにここを参照します。scheduling-and-queue = タイミング/リズム、正確性ではありません。tools/integrations/woopsocial.md = このスキルが投稿レベルで適用する共有統合ガイド。
このスキルの接続先
受信元: すべてのフォーマットスキル(作成されたコンテンツ + 選択された postType)とcontent-calendar(計画)。解決先: GET /social-accounts/{id}/platform-inputs(ボード、プライバシーオプション)+ 統合ガイド。送信先: scheduling-and-queue → WoopSocial(isValid 後に POST /posts)、その後 webhooks/配信ステータス による確認。サポート先: cross-platform-repurposing(ターゲットごとの contentOverride)、analytics-and-reporting(ネイティブ配信の読み出し)、experimentation(有効なバリアント)。コンテンツ作成と真実の宣言は、フォーマットスキルと人間に委ねられます。
完了の定義
すべてのターゲットが収集され、1つのプロジェクトに属していることを確認。各ターゲットの必須フィールドが補完され(該当する場合の postType / プライバシー / ボード / 開示 / title)、アカウント固有の値が platform-inputs から解決されている。メディアとコンテンツのルールが適用されている(FBの混在禁止、IGストーリーのメディア、Pinterestの単一メディア、TikTokのフィールド適用範囲)。ファンアウトの競合がある場合は contentOverride または別々の投稿を使用。開示/madeForKids の宣言は真実のまま(バリデーションを通すために変更しない)。POST /posts/validate を実行し、すべてのエラーが解決され、警告が確認された後にアトミック作成を行う。編集は削除して再作成で処理。何も捏造せず、パフォーマンスを約束しない。各プラットフォームのフォーマットスキルや scheduling-and-queue と正しく区別されている。