이미지 처리 가공
기존 이미지에 대한 결정적 처리: 크기 조절/자르기/패딩/포맷 변환/압축/워터마크/둥근 모서리/콜라주/썸네일. 모든 작업은
skills/shared/scripts/image_ops.py(순수 Pillow)를 통해 실행되며, 즉석에서 스크립트를 작성하지 않습니다.
입력
- 하나 이상의 기존 이미지 파일 경로 (png/jpg/webp 등 Pillow 지원 포맷)
- 대상 작업 및 파라미터 (크기, 비율, 품질, 워터마크 텍스트, 콜라주 방식 등)
출력
- 처리된 이미지 파일 (경로는 사용자가 지정하거나 기본적으로
outputs/주제명/에 저장) - 각 명령은
✅ 경로 (너비x높이, 크기KB)를 반환하며,info명령은 json을 출력합니다.
경계 (card-*와의 구분)
- card-quote / card-xiaohongshu / poster-hero / comparison-card = 디자인 및 새 이미지 렌더링 (HTML→스크린샷)
- image-editing = 기존 이미지 가공, 시각적 디자인 없음, 콘텐츠 생성 없음, 픽셀 수준 처리만 수행
- "데이터/텍스트로 이미지 생성" 필요 → chart/infographic/card-* 사용; 이 SKILL은 기존 이미지 파일만 처리
실행 단계
- 입력 이미지 존재 확인, 대상 작업 및 파라미터 명확히 정의
- 프로젝트 루트 디렉토리에서
image_ops.py해당 하위 명령 실행 (아래 참조) - 플랫폼 크기 필요 시
references/platform-sizes.md에서 권장 비율/픽셀 확인 - 출력 경로 및 크기 반환; 여러 단계 작업은 연결 가능 (예: resize 후 compress)
명령어 빠른 참조
스크립트 경로는 통일적으로 skills/shared/scripts/image_ops.py이며, 모두 -h로 파라미터를 확인할 수 있습니다.
# 크기 조절: 너비/높이/퍼센트, --keep-ratio로 비율 유지하며 프레임 내에 맞춤 (늘어나지 않음)
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --percent 50
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080 --height 1440 --keep-ratio
# 자르기: 좌표 기준 또는 중앙에서 지정 크기로 자르기
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --box 100,50,900,650
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --width 1080 --height 1080
# 패딩 (소셜 미디어 맞춤 핵심): 임의 이미지를 1:1 / 9:16 / 16:9로 패딩
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 9:16 --background "#ffffff"
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 1:1 --background "20,20,30"
# 포맷 변환 png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85
# 압축: 지정 품질 또는 목표 파일 크기 상한에 맞춤 (jpg/webp)
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --quality 80
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --max-kb 200
# 워터마크: 텍스트 (위치/투명도/글자 크기/색상, 자동으로 시스템 한글 폰트 찾음) 또는 이미지 (오른쪽 아래 등)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@계정명" --position bottom-right --opacity 0.5 --size 40
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --image logo.png --position bottom-right --scale 0.3 --opacity 0.8
# 둥근 모서리 (투명 png 출력); --radius-percent 50은 원형
python skills/shared/scripts/image_ops.py round -i in.jpg -o out.png --radius 60
python skills/shared/scripts/image_ops.py round -i avatar.jpg -o out.png --radius-percent 50
# 다중 이미지 콜라주: 가로/세로/그리드 NxM (열x행), --cell-width/height로 셀 크기 통일
python skills/shared/scripts/image_ops.py collage -i a.jpg b.jpg c.jpg -o out.jpg --mode horizontal --gap 12
python skills/shared/scripts/image_ops.py collage -i 1.jpg 2.jpg 3.jpg 4.jpg -o out.jpg --grid 2x2 --gap 10 --cell-width 540 --cell-height 540
# 썸네일 (가장 긴 변 기준 픽셀)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256
# 이미지 정보 읽기 (json: 크기/포맷/비율/용량/투명 채널)
python skills/shared/scripts/image_ops.py info -i in.jpg
도메인 지식: 플랫폼 권장 크기
자주 사용되는 플랫폼 권장 사항은 references/platform-sizes.md에 있습니다. 자주 쓰이는 값:
- 샤오홍슈 세로형 이미지/텍스트: 1080×1440 (3:4); 샤오홍슈 동영상/세로형 포스터: 1080×1920 (9:16)
- 위챗 모멘츠 단일 이미지 / 일반 정사각형: 1:1 (예: 1080×1080)
- 가로형 명언/커버: 16:9 (예: 1920×1080); 위챗 공식 계정 헤더 이미지 900×383
- 웨이보 첨부 이미지: 1:1 또는 4:3; 틱톡/위챗 비디오 커버: 9:16 (1080×1920)
적용 방법: 우선 pad (내용 자르지 않고 변형 없이 패딩)로 이미지 보존; 꽉 찬 이미지가 필요하면 crop 중앙에서 목표 비율로 자르기;
단순 용량 축소는 resize/compress 사용.
프로필 인식
- 프로필 있음: 워터마크 텍스트 기본값 = 계정명/handle; 출력 비율 기본값 = 계정의 주 플랫폼에 맞춤 (예: 샤오홍슈 계정 기본 1080×1440)
- 프로필 없음: 사용자가 명시적으로 지정한 파라미터로 실행, 비율 기본값 = 원본 유지, 워터마크는 사용자가 텍스트 제공 필요
의존성 및 오류 처리
- 의존성: Pillow (이미 설치됨,
python -c "import PIL"사용 가능), 순수 표준 라이브러리, 타사 라이브러리 없음 - 스크립트 내장 경계 검사: 파일 없음 / 자르기 영역 초과 / 잘못된 비율 또는 색상 → 종료 코드 2 및
ERROR:출력 - 시스템 한글 폰트를 찾지 못하면 PIL 기본 폰트로 대체하고
WARN출력,--font로 지정 가능 - 자체 테스트:
python skills/shared/scripts/image_ops.py --selftest