platform-specs-and-validation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

platform-specs-and-validation

The cross-cutting publish-readiness skill — make a post correct on every target (required fields, media rules, limits) and run the validate-before-publish loop. It's the keystone the format skills point to. The agent maps fields + fixes spec violations + validates; WoopSocial validates and publishes; content craft and human-judgment calls stay elsewhere.

横跨各平台的发布就绪 skill——让帖子在每个目标上都符合要求（必填字段、媒体规则、限制），并运行发布前验证循环。它是各格式 skill 共同指向的基石。 Agent 负责映射字段 + 修复规范违规 + 验证；WoopSocial 负责验证和发布；内容创作与需要人工判断的决策交由其他环节处理。

The POV: publish-ready, atomically, the first time

核心观点：首次发布即就绪，并保持原子性

WoopSocial validates and publishes atomically —

POST /posts

checks every target together, and if any one fails, nothing is created. There's no update endpoint, so a post that publishes wrong can't be patched (edit = delete + recreate). That makes getting every target's fields right before publish the whole game: the right

postType

, the required per-platform fields, the media rules, and account-specific values (Pinterest board, TikTok privacy) resolved from

platform-inputs

— then

POST /posts/validate

to catch what's left. This skill is where the format skills come to make sure it will actually go through.

WoopSocial 以原子方式进行验证和发布——

POST /posts

会统一检查所有目标，只要任一目标失败，就不会创建任何内容。 由于没有更新端点，发布不正确的帖子无法修补（编辑 = 删除 + 重新创建）。因此，在发布前让每个目标的字段都正确就是关键：要使用正确的

postType

、各平台必填字段、媒体规则，并从

platform-inputs

解析账号特定值（Pinterest board、TikTok privacy）——随后运行

POST /posts/validate

以发现剩余问题。各格式 skill 会汇聚到这里，确保帖子确实能够顺利通过。

The framework: CHECK

框架：CHECK

(Depth:

references/the-check-framework.md

C — Collect the targets + project: list the social accounts; confirm they're in the same project; note each platform's field set.
H — Hydrate per-platform required fields: fill each target's required fields (FB/IG
```
postType
```
; TikTok's eight; YouTube
```
title
```
+
```
privacy
```
; Pinterest
```
pinterestBoardId
```
); resolve account values from
```
GET /social-accounts/{id}/platform-inputs
```
.
E — Enforce media + content rules: FB no image+video mix; IG Stories need media; Pinterest single media; TikTok PHOTO/VIDEO field applicability; use
```
contentOverride
```
or separate posts where fan-out conflicts; respect text limits.
C — Confirm truthful declarations:
```
isBrandedContent
```
/
```
isYourBrand
```
/
```
madeForKids
```
are truthful declarations, not validation knobs — never flip them to clear an error; these stay with the person.
K — Knock it through validation:
```
POST /posts/validate
```
→ fix all errors, review warnings → create (atomic). No update → delete + recreate (only while
```
NOT_STARTED
```
).

（深入说明：

references/the-check-framework.md

。）

C — 收集目标 + project：列出社交账号；确认它们位于同一个 project；记录每个平台的字段集。
**H — 补全各平台必填字段：**填写每个目标的必填字段（FB/IG
```
postType
```
；TikTok 的八个必填字段；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
```
状态下）。

The spec (ground truth — verify-quarterly)

规范（事实依据——每季度核验）

Per-platform postType enums + required-field matrices + media rules + the platform-inputs discovery endpoint + lifecycle facts (atomic create, no update, delivery status, schedule types):

references/woopsocial-publish-spec.md

. The validate-then-create loop, the full

ValidationField

code table +

CreatePostErrorCode

list + worked examples:

references/validation-reference-and-recipes.md

. (The live OpenAPI spec /

tools/integrations/woopsocial.md

are the source of truth; enums and limits move.)

逐平台 postType 枚举 + 必填字段矩阵 + 媒体规则 + platform-inputs 发现端点 + 生命周期事实（原子创建、无更新、投递状态、调度类型）：

references/woopsocial-publish-spec.md

。先验证后创建的循环、完整

ValidationField

代码表 +

CreatePostErrorCode

列表 + 实操示例：

references/validation-reference-and-recipes.md

。（实时 OpenAPI 规范 /

tools/integrations/woopsocial.md

才是事实来源；枚举和限制会发生变化。）

Honest scope (never violate)

诚实的适用范围（绝不违反）

This skill ensures publish-READINESS (fields/media/spec correct + validated) — it doesn't write or improve the creative (the format/content skills do) and can't guarantee performance.
WoopSocial validates + publishes atomically; one failing target fails the whole post. No update → delete + recreate (only while
```
NOT_STARTED
```
).
Disclosure/compliance declarations stay truthful (
```
isBrandedContent
```
/
```
isYourBrand
```
/
```
madeForKids
```
) — never flipped to pass validation; privacy intent + disclosure truthfulness stay with the person.
Resolve account values (board, privacy) from
```
platform-inputs
```
— don't guess. Never fabricate metrics — native analytics only. (Scope, distinctions + connections:
```
references/scope-and-connections.md
```
.)

此 skill 确保发布就绪（字段、媒体、规范正确且已验证）——它不负责编写或改进创意内容（由格式/内容 skill 负责），也无法保证表现。
WoopSocial 以原子方式验证和发布；任一目标失败，整条帖子都会发布失败。 不支持更新 → 删除 + 重新创建（仅在
```
NOT_STARTED
```
状态下）。
披露/合规声明必须保持真实（
```
isBrandedContent
```
/
```
isYourBrand
```
/
```
madeForKids
```
）——绝不能为了让验证通过而反转这些值；隐私意图 + 披露真实性仍由人负责。
从
```
platform-inputs
```
解析账号值（board、privacy）——不要猜测。绝不捏造指标——只使用 native analytics。（范围、区别 + 关联：
```
references/scope-and-connections.md
```
。）

Distinct from its siblings (route correctly)

与同级 skill 的区别（正确分流）

platform-specs-and-validation (this) = the cross-platform field/media/validation layer that makes a post publish-ready on every target · the per-platform format skills (

tiktok-photo-mode

tiktok-video-publishing

threads-post

youtube-publishing-and-metadata

carousel-writer

, …) = craft one platform's content and point here for validation · scheduling-and-queue = timing/cadence, not correctness ·

tools/integrations/woopsocial.md

= the shared integration guide this applies post-level.

platform-specs-and-validation（当前 skill） = 跨平台字段/媒体/验证层，让帖子在每个目标上达到发布就绪状态 · 各平台格式 skill（

tiktok-photo-mode

、

tiktok-video-publishing

、

threads-post

、

youtube-publishing-and-metadata

、

carousel-writer

等）= 创作单个平台的内容，并指向此处进行验证 · scheduling-and-queue = 时机/节奏，而非正确性 ·

tools/integrations/woopsocial.md

= 当前 skill 在帖子层面适用的共享集成指南。

Where this connects

关联关系

Receives from: every format skill (crafted content + chosen postType) and content-calendar (the plan). Resolves with:

GET /social-accounts/{id}/platform-inputs

(boards, privacy options) + the integration guide. Hands to: scheduling-and-queue → WoopSocial (

POST /posts

after

isValid

), then webhooks/delivery status for confirmation. Supports: cross-platform-repurposing (per-target

contentOverride

), analytics-and-reporting (native delivery readout), experimentation (valid variants). Content craft + truthful declarations stay with the format skills + the person.

接收来自：每个格式 skill（已创作的内容 + 已选择的 postType）和 content-calendar（计划）。结合以下信息完成解析：

GET /social-accounts/{id}/platform-inputs

（board、隐私选项）+ 集成指南。交由：scheduling-and-queue → WoopSocial（通过

isValid

后执行

POST /posts

），然后通过 webhooks/delivery status 进行确认。支持：跨平台再利用（逐目标的

contentOverride

）、analytics-and-reporting（原生投递结果）、experimentation（有效变体）。内容创作 + 真实声明仍由格式 skill + 人负责。

Definition of done

完成标准

Every target collected and confirmed in one project; each target's required fields hydrated (postType / privacy / board / disclosure / title as applicable) with account-specific values resolved from platform-inputs; media + content rules enforced (no FB mix, IG-Story media, single Pinterest media, TikTok field applicability) with contentOverride or separate posts where fan-out conflicts; disclosure/madeForKids declarations left truthful (never flipped to pass);

POST /posts/validate

run with all errors resolved and warnings reviewed before an atomic create; edits handled via delete+recreate, nothing fabricated and no promised performance; correctly distinguished from the per-platform format skills and scheduling-and-queue.

已收集每个目标并确认它们属于同一个 project；已补全每个目标的必填字段（按适用情况填写 postType / privacy / board / disclosure / title），且账号特定值已从 platform-inputs 解析；已执行媒体 + 内容规则（禁止 FB 混用、IG Story 媒体、Pinterest 单媒体、TikTok 字段适用性），并在分发冲突时使用 contentOverride 或拆分为多篇帖子；disclosure/madeForKids 声明保持真实（绝不反转以通过验证）；已在原子创建前运行

POST /posts/validate

，解决所有错误并审查警告；通过删除+重新创建处理编辑，不捏造任何数据，也不承诺表现；已正确区分各平台格式 skill 和 scheduling-and-queue。