원본 프롬프트가 유일한 미적 기준입니다

references/original-prompt/zh-CN.md는 이 프로젝트의 유일한 창작·미적 기준입니다. Skill은 원문을 요약하거나 확장하지 않으며 공통 색상 계획, 미적 동기, 제목, 마이크로카피를 추가하지 않습니다. 색, 재료, 구성, 여백, 문구, 타이포그래피는 GPT Image 2가 원본 프롬프트의 규칙대로 수행합니다.

모드와 크기는 원본의 변환 미학을 바꾸지 않고 기존 3:4 상하 출력 컨테이너를 완전히 대체합니다. 각 결과물에는 선택된 하나의 모드 계약만 GPT Image 2에 전달하며, 네 가지 대안을 하나의 범용 템플릿에서 해석하게 하지 않습니다.

조합 가능한 네 가지 출력

top-bottom, left-right, design-only, wallpaper-pack을 하나 이상 선택할 수 있습니다. 여러 모드를 고르면 각 모드를 독립 프롬프트로 따로 생성합니다.

• top-bottom: 현실 화면은 위, 디자인 변환은 아래에 놓인 하나의 완성 캔버스입니다.
• left-right: 위에서 아래까지 좌우 구조를 유지하며 원본은 왼쪽, 디자인은 오른쪽에 둡니다. 문구도 이 구조 안에 통합하고 너비는 비대칭일 수 있습니다.
• design-only: 원본은 보이지 않는 참조이며, 보이는 모든 요소가 해당 Panel의 디자인 변환 언어를 따릅니다.
• wallpaper-pack: 각 기기마다 디자인 변환만으로 된 전체 화면 배경을 독립적으로 재구성합니다.

경계선, 중앙 비율, 픽셀 좌표는 측정하지 않습니다. 결정론적 합성은 사용자가 정확한 분할이나 원본 픽셀 보존을 명시한 경우에만 사용합니다.

일반 크기도 복수 선택할 수 있습니다: 자동 맞춤, 원본 비율, 1:1, 3:4, 4:3, 4:5, 5:4, 2:3, 3:2, 9:16, 16:9, 21:9, 5:7, 7:5, 사용자 비율／정확한 픽셀. 암묵적 기본 크기는 없습니다. 서로 다른 비율은 동일한 원본 프롬프트에서 각각 다시 구성합니다.

배경화면 세트는 연속형 또는 독립형입니다. 연속형은 먼저 기준 이미지 한 장을 만들고, 나머지는 원본 사진＋기준 이미지를 함께 참고해 각 기기에 맞게 재구성합니다. 한 이미지를 네 크기로 기계적으로 자르지 않습니다.

호출마다 작업 디렉터리는 하나만 만들고 모든 최종 PNG를 그 안에 바로 저장합니다. 원본, 모드, 크기, 기기별 하위 폴더를 만들지 않으며 원본 순서와 정리된 원본 이름을 포함한 source-001-street-left-right-3x2-2160x1440.png, source-001-street-wallpaper-linked-phone-1440x3200.png 같은 파일명으로 구분합니다.

이미지 폴더를 직접 전달하면 이 병사 Skill이 같은 Panel 059의 원본 미학으로 일괄 처리합니다. 일반 래스터 형식을 기본적으로 재귀 탐색하고 수량을 먼저 알린 뒤 모드·크기·텍스트·언어를 한 번만 확인합니다. 각 이미지는 내용이나 문구가 섞이지 않도록 독립 생성하며 전체 배치는 하나의 평면 작업 디렉터리만 사용합니다. 개별 실패는 기록하고 이후 이미지를 조용히 누락하지 않습니다.

텍스트 모드

생성 전에 다음 중 하나를 정합니다.

1. 원본 프롬프트에 따라 모델이 텍스트 생성: 사용자는 언어 또는 지역만 지정하고, 내용·분량·톤·타이포그래피는 GPT Image 2가 원문 규칙대로 생성합니다. 모든 문구는 현재 이미지의 내용·분위기·함의에서 나오며, 사실이나 자료처럼 보이는 정보는 사용자 제공·이미지에서 확인 가능·검증된 근거가 있어야 합니다.
2. 내 정확한 문구 사용: 한 글자도 바꾸지 않고 전달하며 재작성, 번역, 제목 추가를 하지 않습니다. 배치는 원문을 따릅니다.
3. 텍스트 없음: 모든 텍스트와 가짜 문자를 금지합니다.

외부 Skill은 제목이나 마이크로카피를 미리 쓰지 않습니다. 출력 언어는 인터페이스 언어와 별도로 확인하며 인물, 장면, 파일명에서 추정하지 않습니다.

완성 캔버스 우선과 래스터 경계

이미지 모델이 완성 화면 전체의 미학적 재구성을 담당하며 이중 패널도 완성 캔버스 한 장의 직접 생성을 기본으로 합니다. scripts/compose_panel.py는 조건부 복구, 무손실 픽셀 조정, 읽기 전용 검수에만 사용하고 매번 사전 계획하거나 미학적 성공을 판단하지 않습니다.

모든 결과물은 PNG 래스터이며 호출마다 ~/Desktop/xxd/에 새 작업을 만듭니다. 설정된 이미지 경로는 비식별 상태만 반환하며 제공자, 엔드포인트, 인증 정보, 헤더, 프롬프트, 응답, 계정 정보를 공개하지 않습니다. SVG, HTML, Canvas, 도표와 프로그램 그림은 최종 작품을 대신할 수 없습니다.

호스트 기능에 맞춘 질문과 인라인 매개변수

같은 Skill이 호스트가 실제로 제공하는 상호작용 기능에 맞춰 동작하며 장식 기호를 클릭 가능한 UI처럼 보이게 하지 않습니다.

• Claude Code에 AskUserQuestion + multiSelect: true가 있으면: 모드와 크기는 실제 체크박스, 텍스트 방식과 배경화면 관계는 단일 선택을 사용합니다. 일반 크기는 정사각형·세로·가로 그룹으로 나누고 선택을 누적하며 사용자 크기는 자유 입력합니다.
• Codex에 request_user_input만 있으면: 텍스트 방식과 배경화면 관계처럼 상호 배타적인 항목에만 사용합니다. 모드와 크기를 단일 선택처럼 꾸미지 않고 조합 입력으로 받습니다.
• 상호작용 도구가 없으면: 첫 번째 질문에서 모드, 두 번째 질문에서 크기＋텍스트 방식을 입력합니다. 가짜 - [ ]를 표시하지 않고 폼만을 위해 Plan mode 전환을 요구하지 않습니다.

두 번째 질문은 처음에 스마트 추천／원본 비율／일반 비율／사용자 지정만 보여 줍니다. 일반 비율을 선택할 때만 정사각형 1:1, 세로 3:4, 4:5, 2:3, 9:16, 5:7, 가로 4:3, 5:4, 3:2, 16:9, 21:9, 7:5를 펼칩니다. 여러 비율과 정확한 픽셀을 함께 지정할 수 있습니다.

모든 설정은 인라인으로도 전달할 수 있습니다.

/xxd-panel-059 photo.jpg --mode top-bottom,design-only --size auto,3:4,9:16 --text prompt --locale ja-JP

--mode, 반복 가능한 --size, --text prompt|exact|none, --locale, --copy, --wallpaper linked|independent, --wallpaper-size, --out, --prefs를 지원합니다. 값이 모두 있으면 질문을 건너뛰고, 일부만 있으면 누락된 항목만 묻습니다.

지난 설정을 이어 쓰거나 새로 설정하기

유효한 기록이 있고 이번 전달 설정이 아직 완성되지 않았으면, Skill이 지난 모드, 크기, 텍스트와 언어, 배경화면 관계, 출력 위치를 요약한 뒤 그대로 사용, 불러온 뒤 수정, 새로 설정의 세 가지 상호 배타적 선택지를 제공합니다. 이번 호출에서 명시한 요구가 항상 우선하며, 필요한 매개변수가 모두 있으면 불필요한 질문을 하지 않습니다.

--prefs last|edit|new|off|clear로 동작을 바로 지정할 수 있습니다.

/xxd-panel-059 photo.jpg --prefs last
/xxd-panel-059 photo.jpg --prefs edit
/xxd-panel-059 photo.jpg --prefs new

기록에는 전달 설정만 저장합니다. 원본 이미지, 정확한 문구, 생성 결과, Panel 선택, 모델 경로, API 자격 증명이나 기타 민감한 정보는 저장하지 않습니다.

photo.jpg 대신 이미지 폴더 경로를 전달하면 별도의 --batch 옵션 없이 자동으로 일괄 처리합니다.

매개변수 빠른 참조

photo.jpg는 로컬 경로, 업로드 이미지, 이미지 폴더 또는 사용자가 명시한 다른 입력으로 바꿀 수 있습니다. 폴더는 자동으로 일괄 처리됩니다.

용도별 복사 명령

# 상하 비교: 캔버스 자동 추천, 한국어 문구 생성
/xxd-panel-059 photo.jpg --mode top-bottom --size auto --text prompt --locale ko-KR

# 좌우 비교: 3:2 가로형, 글자 없음
/xxd-panel-059 photo.jpg --mode left-right --size 3:2 --text none

# 디자인 전용: 9:16 휴대폰 세로형, 한국어 문구
/xxd-panel-059 photo.jpg --mode design-only --size 9:16 --text prompt --locale ko-KR

# 연결형 4종 배경화면: 기준 이미지 후 기기별 재구성
/xxd-panel-059 photo.jpg --mode wallpaper-pack --wallpaper linked --text none

# 독립형 배경화면: 기기별 정확한 해상도 지정
/xxd-panel-059 photo.jpg --mode wallpaper-pack --wallpaper independent --wallpaper-size phone=1440x3200,ipad=2048x2732,desktop=3840x2160,watch=1024x1024 --text none

# 원본 이미지 비율 따르기
/xxd-panel-059 photo.jpg --mode design-only --size source --text none

# 정사각형·세로·가로 완성 구도를 각각 생성
/xxd-panel-059 photo.jpg --mode design-only --size 1:1,3:4,16:9 --text none

# 사용자 비율과 정확한 픽셀을 함께 지정
/xxd-panel-059 photo.jpg --mode design-only --size 11:14,2160x3840,3840x2160 --text none

# 원본 프롬프트가 문구를 만들고 언어만 제한
/xxd-panel-059 photo.jpg --mode design-only --size 3:4 --text prompt --locale ko-KR

# 정확한 문구를 재작성·번역·제목 추가 없이 사용
/xxd-panel-059 photo.jpg --mode design-only --size 3:4 --copy "빛을 이곳에 남겨 두기" --locale ko-KR

# 2개 모드 × 3개 크기로 독립적인 완성 구도 6개 생성
/xxd-panel-059 photo.jpg --mode top-bottom,design-only --size 1:1,3:4,9:16 --text prompt --locale ko-KR

# 폴더 전체에 Panel 059 적용, 공통 설정은 한 번만 확정
/xxd-panel-059 "/path/to/photos" --mode design-only --size auto,9:16 --text prompt --locale ko-KR

# 반복 매개변수도 누적하며 지정 루트 아래로 출력
/xxd-panel-059 photo.jpg --mode top-bottom --mode left-right --size 3:4 --size 16:9 --text none --out ./deliveries

이미지 모델 우선순위

GPT Image 2를 기본 최우선 모델로 사용합니다. 고충실도 원본 참조, 생성 전 완성 캔버스 확인, 이중 패널의 완성 화면 일괄 생성, 조건이 충족될 때만 사용하는 스크립트 합성이라는 기존 흐름은 그대로 유지합니다.

현재 도구 또는 설정된 경로에서 실제로 사용할 수 있고 원본 충실도, 완성 화면비, 대상 언어의 문자, 연결형 배경화면의 다중 참조 요구를 충족할 때는 Seedance 5.0 Pro, Nano Banana Pro(Gemini Image Pro), Nano Banana 2(Gemini Image Flash) 또는 다른 호환 비트맵 모델도 사용할 수 있습니다. 대체 모델은 생성 경로만 바꾸며 모드, 캔버스, 문구, 언어, 배경화면 관계와 완성 캔버스 우선 전략을 바꾸지 않습니다.

적합한 경로가 없으면 이미지 생성 도구를 활성화하거나 API Key를 제공하도록 사용자에게 요청합니다. 사용자가 제공한 인증 정보는 현재 작업에 사용할 수 있지만 답변이나 로그에 다시 표시·기록·노출하지 않습니다. 사용자가 명시적으로 요청하지 않는 한 장기 저장하거나 제공자, 계정, 결제 또는 전역 경로 설정을 변경하지 않습니다.