플랫폼 사양 및 검증은(는) 무엇을 하나요?
크로스-커팅 게시 준비 스킬 — 모든 대상 플랫폼에서 올바른 게시물을 작성하고(필수 필드, 미디어 규칙, 제한 사항), 게시 전 검증 루프를 실행합니다. 이는 포맷 스킬들이 참조하는 핵심 스킬입니다. 에이전트는 필드를 매핑하고 사양 위반을 수정하며 검증합니다; 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개; 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은 원자적으로 검증하고 게시합니다; 하나의 실패 대상이 전체 게시물을 실패시킵니다. 업데이트 없음 → 삭제 후 재생성(
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/전달 상태로 확인. 지원하는 곳: cross-platform-repurposing(대상별 contentOverride), analytics-and-reporting(네이티브 전달 읽기), experimentation(유효한 변형). 콘텐츠 제작 + 진실한 선언은 포맷 스킬 + 사람과 함께 남습니다.
완료 정의
모든 대상이 수집되고 하나의 프로젝트로 확인됨; 각 대상의 필수 필드(postType / 개인정보 / 보드 / 공개 / title 적용 가능한 대로)가 platform-inputs에서 해결된 계정별 값으로 채워짐; 미디어 + 콘텐츠 규칙 적용됨(FB 혼합 금지, IG-스토리 미디어, Pinterest 단일 미디어, TikTok 필드 적용 가능성) 팬아웃 충돌 시 contentOverride 또는 별도 게시물 사용; 공개/madeForKids 선언이 진실하게 유지됨(검증 통과를 위해 절대 변경하지 않음); POST /posts/validate 실행되어 모든 오류가 해결되고 경고가 검토된 후 원자적 생성; 수정은 삭제 후 재생성으로 처리, 아무것도 조작하지 않으며 성능을 약속하지 않음; 플랫폼별 포맷 스킬 및 scheduling-and-queue와 올바르게 구분됨.