프롬프트 게시판 운영 스킬 (prompt-board-ops) — 스킬 글 버전 동기화

프롬프트 게시판 운영 스킬은 로컬 Codex 스킬과 ai.eond.com/prompt 게시글을 찾아 버전, 본문, 태그와 마켓 메타를 동기화하는 운영 스킬입니다.

이런 경우에 사용하세요

새 Codex 스킬을 Prompt 게시판에 등록할 때
기존 스킬 글을 새로 만들지 않고 업데이트할 때
로컬 스킬 버전과 게시글 버전을 맞출 때
태그, 무료 배지, 라이선스, 하이라이트를 일괄 갱신할 때

사용 방법

프롬프트 게시판 운영 스킬을 사용해서
로컬 스킬과 기존 Prompt 글을 비교하고 업데이트해줘.

스킬은 먼저 로컬 .codex/skills/{skill-name}/SKILL.md와 references를 읽고, Prompt 게시판 목록에서 기존 글을 검색합니다. 스킬명, slug, 제목의 괄호 안 식별자, 버전을 기준으로 매칭하며 기존 글이 있으면 중복 등록하지 않습니다.

표준 처리 흐름

로컬 스킬과 현재 버전을 확인합니다.
GET /api/boards/prompt로 게시글 목록을 조회합니다.
기존 문서의 제목, 본문, 태그, 메타를 비교합니다.
변경된 필드만 업데이트 payload에 담습니다.
PUT /api/boards/prompt/{document_srl} 부분 업데이트 API를 우선 사용합니다.
응답의 ok와 updated를 확인합니다.
공개 게시글을 다시 조회해 실제 반영 결과를 검증합니다.

부분 업데이트 API

다음 필드를 필요한 만큼만 보낼 수 있습니다.

PUT /api/boards/prompt/{document_srl}
{
  "version": "1.1",
  "tags": "AI스킬,Codex,무료,스킬",
  "badge": "FREE",
  "license": "무료 사용 · 필요에 맞게 수정 가능",
  "highlights": ["버전 비교", "중복 방지", "등록 후 검증"]
}

미전송 또는 null: 기존 값 유지
값: 해당 값으로 설정
빈 문자열: 해당 메타 키 제거
같은 값: no-op

기존에 정의되지 않은 extra_vars 키는 보존합니다. 본문을 변경할 때는 빠진 인라인 이미지가 정리되는지도 확인합니다.

실패 처리

네트워크, 인증, CSRF, 기존 글 매칭, 버전 비교, 입력 검증, 서버 오류를 구분해 기록합니다. 새 글을 만들기 전에 기존 글을 찾지 못한 이유를 확인하며, 등록 요청 전송만으로 성공 처리하지 않습니다.

API가 없는 구버전 서버에서만 인증된 웹 폼을 fallback으로 사용합니다. 외부 접속, 관리자 세션, Origin·Referer, 등록 후 재조회가 필요할 수 있습니다.

무료 공개 범위

무료로 제공하며 프로젝트에 맞게 수정·재사용할 수 있습니다. 게시판 API와 인증 정책은 사용하는 서버 환경에 맞게 확인해야 합니다.

연관 스킬: eond-prompt-register, eond-register-system, contentsmaker, app-development-discovery