gongnyang/gongnyang-prompt-kit

거친 요청 → 완성 프롬프트 → 검증기 통과 — 세 단계가 스킬 안에서 끝난다. 위 키비주얼도 이 킷으로 컴파일한 프롬프트(C11 시네마틱 키아트)로 생성했다.

왜 필요한가

• 나이브 프롬프트는 진다 — “포스터 하나 만들어줘” 수준의 한 줄을 그대로 넣으면, 모델은 그 막연함 그대로의 결과를 돌려준다.
• 컴파일러 접근 — 요청 신호를 라우팅 표에서 한 행으로 매핑하고, 그 패턴 하나로 바로 생성에 넣을 수 있는 완성 한국어 프로덕션 프롬프트를 만든다.
• 검증기 게이트 — 화이트리스트 밖 네거티브·SD 폐기 어휘·사이즈 락 위반은 생성으로 넘어가기 전에 error로 잡힌다.
• 생성은 범위 밖 — 대량 생성은 codex-fleet의 codex-imagegen 스킬, 한 장이면 codex에 직접 넣는다.

차이는 프롬프트뿐

같은 gpt-image-2다 — 왼쪽은 사람이 친 한 줄(개쩌는 이미지 하나 만들어줘)을 그대로 넣은 결과, 오른쪽은 그 한 줄을 킷이 컴파일해서 넣은 결과.

전체 컴파일 레코드는 examples/showcase.jsonl.

Quickstart

git clone https://github.com/gongnyang/gongnyang-prompt-kit
ln -s "$PWD/gongnyang-prompt-kit/skills/image-prompt" ~/.claude/skills/image-prompt

Claude Code에서 “이미지 프롬프트 써줘” · “화보 프롬프트” · “키아트” · “타이포 포스터” 같은 트리거나 /image-prompt로 실행한다.

node skills/image-prompt/scripts/check_prompt.mjs examples/poster.txt   # 작성한 프롬프트 검사

{ok, format, tier, errors, warnings} JSON을 반환하며, 통과·실패 샘플은 examples/에 있다.

[!NOTE] 심볼릭 링크로 설치하면 레포 업데이트가 자동 반영된다. 검증기 실행에는 Node.js, 생성까지 이으려면 Codex CLI 로그인 + ChatGPT Plus/Pro가 필요하다.

라우팅

v3의 코어는 라우팅 표 하나다 — 요청 신호로 한 행을 고르고, 그 행이 가리키는 레퍼런스 파일 하나만 읽는다. 라우팅 정본은 skills/image-prompt/SKILL.md의 표 한 곳뿐이며, 아래는 그 독자용 미러다.

라이브러리 커버 범위: 카테고리 C1–C12 · 타이포 포스터 TP1–TP17 · 홍보판촉물 P1–P12 · 룩 프리셋 L1–L9 · 컨셉 축 M1–M10 / R / X / T1–T5.

핵심 규칙

잘 나오게 하는 규칙이 아니라 안 나오게 만드는 습관을 막는 규칙이다 — 전문은 skills/image-prompt/SKILL.md §철칙.

베스트 컷

v4.0 신규 패턴 7종

신규 7패턴 컴파일 레코드 49건은 examples/foundry-wave1.jsonl.

갤러리 전체(전후 비교 21페어·TP 17종·P 12컷·L9 12컷) → 데모 사이트 · 고밀도 도표 대표컷은 examples/diagram-gallery/

구조·릴리스·라이선스

SKILL.md에는 항상 로드되는 코어만 두고, 깊은 디테일은 references/로 분리했다(progressive disclosure).

변경 이력·검증 실측 → GitHub Releases · 릴리스 체크리스트 RELEASING.md · 라이선스 MIT

감사

• @fivetaku — 킷 전체 외부 감사(#6): 검증기 스키마 게이트 8종 신설, 회귀 픽스처 16→27종, CI 도입, 링크·예제 경로 결함 수정. 전 항목 실측 재현으로 확인된 정확한 감사였습니다. 🙇

---