mkdir -p ~/.claude/skills/claude-codex-image/references
# 把 Part 1 寫進 SKILL.md
# 把 Part 2 寫進 references/3-step-setup.md
# 把 Part 3 寫進 references/prompt-template.md

---
name: claude-codex-image
description: 教 Claude Code 怎麼自動調用 Codex CLI 跑 GPT Image-2 生圖、繞過 ChatGPT chat 端手動點按鈕。Use when 需要產出含繁中字的封面、infographic、簡報配圖；要批量生視覺一致的圖；想自動化生圖工作流。Do NOT use for 單張快速 iterate（ChatGPT 直接點較快）、無中文字的多插圖場景（用 gemini-image-gen 較划算）。
---

# Claude Code × Codex × Image-2 橋接 Skill

讓 Claude Code 自動調用 Codex CLI 跑 GPT Image-2 生圖、跳過 ChatGPT chat 端手動點按鈕的工作流。

## 核心 reframe

Codex 不只是 code reviewer 或開發工具——對 Claude Code 來說，它是**生圖外掛**。

三角色分工：
- **Claude Code** = 大腦（規劃、寫 prompt、品質把關）
- **Codex** = 手（接 Claude Code 的指令、跑 Image-2 tool）
- **Image-2** = 視覺（產生 PNG）

## 適用場景

✓ 產出含繁中字的視覺（封面、infographic、簡報、carousel）
✓ 批量生視覺一致的圖（Reference image pin 機制）
✓ 想把生圖整合進自動化內容工作流
✓ 在意品質而非速度（Image-2 慢但繁中字筆劃精準）

## 不適用

✗ 單張快速 iterate（用 ChatGPT chat 直接點較快）
✗ 純插圖無字（gemini-image-gen 較划算、快 5-10 倍）
✗ 沒有 ChatGPT Plus / Pro 訂閱（Codex 走訂閱、要 login ChatGPT）

## 上手 3 步驟

完整步驟見 references/3-step-setup.md（本文件 Part 2）：

1. `npm install -g @openai/codex@latest`
2. `codex login`（選 ChatGPT Plus / Pro）
3. 跑第一張圖：`echo "<prompt>" | codex exec --full-auto --cd <output-dir>`

## 基本命令模板

```bash
# 單張生圖（最簡）
echo "<your image prompt>" | codex exec --full-auto --cd <output dir>

# 帶 reference image（鎖風格 / 鎖人物）
echo "<prompt>" | codex exec --full-auto --cd <dir> \
  -i <reference1.png> \
  -i <reference2.png>

# 背景跑（適合 9 張 carousel ≈ 12-15 分鐘）
# Claude Code 端用 background bash + run_in_background: true

---

# Part 2 — 3 步驟設定（references/3-step-setup.md）

## Step 1: 安裝 Codex CLI

```bash
npm install -g @openai/codex@latest

codex --version
# 應顯示 0.125+

npm install -g @openai/codex@latest --force

codex login

codex login status
# 應顯示 "Logged in using ChatGPT"

codex logout
codex login  # 選 ChatGPT 而不是 API key

mkdir ~/test-codex-image && cd ~/test-codex-image

echo "Generate a 1024x1280 portrait illustration of a cozy home office with warm lighting, flat line-color editorial style, paper texture background. Output PNG only, no text in image." | codex exec --full-auto --cd .

sips -g pixelWidth -g pixelHeight *.png

echo "<prompt>" | codex exec --full-auto --cd . \
  -i ~/path/to/avatar-baseline.png \
  -i ~/path/to/style-baseline.png

# GOOD
cat my-prompt.txt | codex exec --cd . --full-auto

# BAD (shell 會斷行壞掉)
codex exec --cd . --full-auto "line 1
line 2
line 3"

cd ~ && git status --short

You are an editorial illustrator. Generate a 1024x1280 portrait illustration.

STYLE:
- Flat line-color editorial illustration
- Warm color palette (no AI gradient)
- Paper texture background, subtle warm spotlight
- Background single warm white #FDFCF9

SUBJECT:
{{your scene description, e.g. "A person sitting at a wooden desk with a closed laptop, soft window light from the left, plants on the desk"}}

TEXT OVERLAY (render exactly, no other text in image):
- Top-left kicker: "{{KICKER}}" UPPERCASE letter-spacing 2px, 24px, weight 800, color #D4623B
- Center H1: "{{你的標題}}" weight 900, max 14 Chinese characters, color #0F172A
- Bottom-right page: "01 / 09" 24px regular, color #64748B (only if you need page number)

CONSTRAINTS:
- Only the verbatim strings above may appear in the image
- No emoji, no QR code, no URLs, no fake buttons
- No additional auto-generated text on props, signs, or scenery
- No watermark, no logo, no brand mark

[同 STYLE 同 CONSTRAINTS as 場景 A]

LAYOUT: horizontal 3-card grid, equal size, equal spacing
- Card 1:
  - icon: {{描述 icon 1}}
  - label: "{{標題 1}}" weight 700
  - support: "{{說明 1}}" weight 400
- Card 2:
  - icon: {{描述 icon 2}}
  - label: "{{標題 2}}"
  - support: "{{說明 2}}"
- Card 3:
  - icon: {{描述 icon 3}}
  - label: "{{標題 3}}"
  - support: "{{說明 3}}"

H1 above the cards: "{{你的主標}}" max 14 Chinese characters

[同 STYLE 同 CONSTRAINTS]

LAYOUT: left-right compare, two columns equal width
- LEFT (label "BEFORE" small caption above):
  - {{描述 BEFORE 視覺}}
- RIGHT (label "AFTER" small caption above):
  - {{描述 AFTER 視覺}}

H1 above: "{{你的主標}}" max 14 Chinese characters
Footer takeaway pill: "{{takeaway}}" max 18 Chinese characters

[同 STYLE]

LAYOUT: full-bleed hero
SUBJECT: {{你的場景 / 角色 / 道具描述}}
TEXT (only if needed):
- Title: "{{標題}}" max 18 Chinese characters

CONSTRAINTS: [同上、額外允許]
- {{若需要更大留白讓你後製文字、加: "Leave 30% of the bottom area as clean negative space for additional copy"}}

W=$(sips -g pixelWidth raw.png | tail -1 | awk '{print $2}')
H=$(sips -g pixelHeight raw.png | tail -1 | awk '{print $2}')

if [ $((W*1350)) -lt $((H*1080)) ]; then
  # native 更窄高 → resize width 到 1080 保 aspect
  sips --resampleWidth 1080 raw.png --out tmp.png
else
  # native 更寬 → resize height 到 1350 保 aspect
  sips --resampleHeight 1350 raw.png --out tmp.png
fi
sips -c 1350 1080 tmp.png --out final.png  # center crop
rm tmp.png

echo "<prompt 內必寫: 'Preserve the exact same face, glasses shape, hair, skin tone as reference image 1. Only clothing, pose, scene may vary.'>" | \
  codex exec --full-auto --cd . \
  -i <avatar-baseline.png>

# 在 Claude Code 對話中：
cat codex-instruction.txt | codex exec --full-auto --cd <cwd> \
  -i <ref1> -i <ref2> 2>&1 | tee /tmp/codex.log