platform-specs-and-validation

platform-specs-and-validation

跨平台发布就绪技能——确保帖子在所有目标平台上都符合要求（必填字段、媒体规则、限制），并执行发布前验证流程。它是各格式技能所指向的关键基石。Agent 映射字段 + 修正规范违规 + 验证；WoopSocial 负责验证并发布；内容创作和需要人工判断的事项由其他技能处理。

核心理念：一次性原子发布就绪

WoopSocial 会原子地验证并发布——POST /posts 会同时检查所有目标平台，只要有一个失败，就不会创建任何内容。没有更新端点，因此发布错误的帖子无法修补（编辑 = 删除 + 重新创建）。所以，整个关键在于发布前确保每个目标平台的字段都正确：正确的 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 只支持单个媒体；遵守 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 (this) = 跨平台字段／媒体／验证层，确保帖子在每个目标平台都可发布 · 各平台格式技能（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/delivery status 确认。支持：cross-platform-repurposing（按目标平台设置 contentOverride）、analytics-and-reporting（原生投放结果）、experimentation（有效 变体）。内容创作 + 如实申报仍由格式技能 + 用户负责。

完成标准

在一个项目中收集并确认所有目标；为每个目标填充所需字段（适用时包括 postType / 隐私／看板／披露／标题），并通过 platform-inputs 解析账号专属的值；执行媒体 + 内容规则（不得混用 FB 内容、 IG-Story 媒体、Pinterest 单媒体限制、TikTok 字段适用性），对于分发冲突使用 contentOverride 或创建独立帖子； 如实填写披露／madeForKids 声明（绝不为了通过验证而篡改）；执行 POST /posts/validate，解决所有错误并检查警告后再原子式创建；通过删除后重新创建来处理编辑，不得捏造信息或承诺效果；正确区分本技能与各平台格式技能及 scheduling-and-queue。