platform-specs-and-validation

platform-specs-and-validation

プラットフォーム横断の公開準備スキルです。すべての対象で投稿が正しくなるようにし（必須フィールド、メディアルール、制限）、公開前に検証するループを実行します。フォーマットスキルが参照する要となるスキルです。エージェントはフィールドを対応付け、仕様違反を修正し、検証します。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つのフィールド、YouTube の title と privacy、Pinterest の pinterestBoardId）。GET /social-accounts/{id}/platform-inputs からアカウントの値を解決します。
• E — メディアとコンテンツのルールを適用する： FB では画像と動画を混在させないこと、IG Stories にはメディアが必要であること、Pinterest ではメディアが1つであること、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/delivery status。対応するもの：cross-platform-repurposing（ターゲットごとの contentOverride）、analytics-and-reporting（ネイティブの配信結果）、experimentation（有効なバリエーション）。コンテンツの作成と正確な申告は、形式スキルと担当者が行います。

完了の定義

すべてのターゲットが1つのプロジェクトで収集・確認されていること。各ターゲットの必須フィールド（該当する場合は postType／プライバシー／ボード／開示事項／タイトル）が入力され、platform-inputs からアカウント固有の値が解決されていること。メディアとコンテンツのルール（FB の混在禁止、IG-Story のメディア、Pinterest のメディアは1つ、TikTok のフィールド適用範囲）が、fan-out に競合がある場合は contentOverride または個別の投稿で適用されていること。開示事項／madeForKids の申告が正確であること（通過させるために変更しないこと）。POST /posts/validate を実行し、すべてのエラーを解決し、警告を確認してから一括作成すること。編集は削除＋再作成で対応し、情報を捏造せず、成果を保証しないこと。また、プラットフォームごとの形式スキルや scheduling-and-queue と正しく区別されていること。