wiraperdana/claude-imagegen

claude-imagegen은(는) 무엇을 하나요?

이 스킬은 에이전트를 Codex 내장 image_gen 도구에 연결합니다. 이 도구는 사용자의 ChatGPT 로그인을 사용하므로 OPENAI_API_KEY가 필요하지 않습니다.

간단한 비유를 들자면, 에이전트는 아트 디렉터 역할을 합니다. 에이전트는 브리프를 작성하고, 이를 일러스트레이터(Codex)에게 보낸 후, 결과물을 사용하기 전에 확인합니다. 일러스트레이터는 빠르게 작업하지만 가끔 레이블 철자를 틀리거나 화살표 방향을 반대로 그리기도 합니다. 따라서 시각적 확인은 선택 사항이 아닌 필수 단계입니다.

사용 시기

• 사용자가 imagegen GPT로 제작된 일러스트, 스토리 장면, 또는 자료용 이미지를 요청할 때.
• 사용자가 기존 이미지와 일관된 스타일의 그림을 원할 때.

정밀한 레이블이 많은 다이어그램의 경우, 먼저 SVG나 HTML을 제안하세요. Imagegen은 장면을 표현하는 데 가장 뛰어나며, 긴 텍스트에는 가장 취약합니다.

실행 중인 에이전트가 Codex 자체라면, 내장 image_gen 도구를 직접 사용하세요. Codex 내부에서 codex exec를 호출하지 마십시오.

전제 조건

1. codex가 PATH에 있고 ChatGPT 계정으로 로그인되어 있어야 합니다. codex login status로 확인하세요.
2. image_generation 기능이 활성화되어 있어야 합니다. codex features list | grep image_generation으로 확인하세요.
3. 선택 사항: WebP 생성을 위한 cwebp, 이미지 크기 확인을 위한 sips(macOS) 또는 Python Pillow.

전제 조건이 충족되지 않으면 작업을 중단하고 부족한 점을 언급하세요. 조용히 유료 API로 전환하지 마십시오.

실행 전, 사용자에게 두 가지를 알리세요

• 브리프와 참조 이미지가 OpenAI로 전송됩니다. 명시적 허가 없이 기밀 이미지, 개인 데이터 또는 클라이언트 자료를 첨부하지 마십시오.
• 각 이미지는 ChatGPT 구독의 할당량을 사용합니다. 테스트 이미지 하나는 약 18,000 토큰을 사용하며, 소요 시간은 약 2분입니다.

참조 내용의 유형이 바뀌지 않는 한, 세션당 한 번만 알리면 됩니다.

절차

1. 요구사항 수집. 명확하지 않은 것만 질문하세요: 이미지 목적, 비율(기본값 3:2 가로), 반드시 포함되어야 할 텍스트, 스타일 참조 이미지, 저장 위치.
2. 영어로 브리프를 작성하고 references/brief-template.md를 사용하세요. 허용할 텍스트를 정확히 명시하고, 다른 모든 텍스트, 워터마크, 로고를 금지하세요.
3. 스크립트 실행:

   scripts/gen.sh --out <경로/이름.png> --brief <brief.txt> [--ref <이미지.png>]... [--style-guide <AGENTS.md>] [--no-refine] [--webp 1400]
   

   스크립트는 브리프에 저장 지시를 추가하고, stdin을 통해 브리프를 보내며 결과를 복사합니다. 브리프는 stdin을 통해 전달되어야 하는데, Codex의 -i 옵션이 그 뒤의 위치 인수를 삼켜버리기 때문입니다. --dry-run을 사용하면 할당량을 소모하지 않고 명령어를 확인할 수 있습니다. Codex에 의한 개선(기본값). 그리기 전에, Codex가 아트 디렉터 역할을 합니다. 즉, 하나의 핵심 아이디어, 명확한 시각적 위계, 일반인이 바로 이해할 수 있는 시각적 은유를 갖춘 더 강력한 프롬프트로 브리프를 재작성합니다. 숫자, 이름, 인용, 기술 용어는 정확히 유지해야 합니다. 개선된 프롬프트와 이미지 내 텍스트 목록은 <이름>.refined.txt에 저장됩니다. 좁은 범위의 수정 등 브리프를 그대로 사용해야 하는 경우 --no-refine을 사용하세요. 스타일 가이드. --style-guide <file.md> 또는 환경 변수 CLAUDE_IMAGEGEN_STYLE_GUIDE는 언어 및 교수법 규칙(예: 특정 워크스페이스의 AGENTS.md)을 첨부합니다. Codex는 해당 파일의 언어 규칙, 문장 스타일 및 교수법만 적용합니다.
4. 결과를 시각적으로 검사하세요. PNG를 열고 references/qa-checklist.md의 목록을 확인하세요: 모든 레이블의 철자, 화살표 방향, 잘못된 텍스트, 비율, 스타일 일치.
5. 필요시 수정하되, 최대 두 번까지 가능합니다. 다음 중 하나를 선택하세요:
   • 브리프를 수정하고 다시 실행하거나,
   • 이전 결과를 --ref로 첨부하고 좁은 범위의 수정 지시와 함께 실행하세요. 예: "다른 것은 그대로 두고, 레이블 X만 Y로 변경하세요."
6. 제출. PNG 경로, WebP 경로(있는 경우), 픽셀 크기, 시각적 검사 결과를 보고하세요. 남아있는 단점도 언급하세요.

출력물

• <이름>.png: Codex의 원본 이미지.
• <이름>.brief.txt: 사용된 브리프로, 이미지를 재생성하거나 수정할 수 있도록 합니다.
• <이름>.refined.txt: Codex가 개선한 프롬프트와 이미지에 나타난 텍스트 목록입니다. 철자와 숫자 확인에 사용하세요.
• <이름>.webp: --webp가 주어진 경우, 지정된 너비와 고정 비율로 생성됩니다.

Codex는 또한 ~/.codex/generated_images/에 원본 복사본을 저장합니다.

솔직히 알려야 할 제한 사항

• 이미지 모델 버전을 매개변수로 선택할 수 없습니다. Codex가 자체적으로 결정합니다.
• 결과는 결정적이지 않습니다. 동일한 브리프로도 다른 이미지가 생성될 수 있습니다.
• 이미지 내 긴 텍스트는 종종 철자가 틀립니다. 텍스트는 몇 개의 짧은 레이블로 제한하세요.