生成圖片
透過 OpenAI GPT Image 2 建立圖片。驗證透過已登入 ChatGPT 帳號的 Codex CLI 執行,因此圖片生成費用涵蓋在使用者的 Plus 訂閱中。無需 OpenAI API 金鑰,也沒有獨立的單張圖片 API 計費。
開始之前
此技能不直接與 OpenAI 通訊。它會呼叫 Codex CLI,而該 CLI 必須事先安裝在這台機器上,並已使用有效的 ChatGPT Plus 訂閱帳號登入。請用 codex --version 檢查,如果尚未登入則執行 codex login。不需要貼上任何 API 金鑰,也沒有單張圖片的額外費用;所有圖片費用都計入該訂閱。
如果沒有已登入的 Codex CLI,這裡的一切都無法運作,腳本會在第一次呼叫時失敗,而非產出任何檔案。
快速開始
# 從此技能自己的目錄執行,無論你的代理安裝在哪裡
./scripts/generate-image.sh "一隻戴著太陽眼鏡的柴犬,棚拍風格"
儲存到解析後的輸出資料夾(見下方說明),檔名為 slugified 的 PNG,例如:
assets/images/yi-zhi-dai-zhe-tai-yang-yan-jing-de-chai-quan-peng-pai-feng-ge.png
工作流程
- 將使用者的請求轉換為強而有力的英文提示詞。請遵循 PROMPTING.md 中的建構順序與槓桿(場景 → 主體 → 細節 → 不變項 → 用途)。在呼叫前先釐清模糊的要求;當資產很重要時,不要只傳遞一句簡單的話。
- 使用提示詞執行腳本。可選擇性地傳遞
--out與--name參數。 - 將儲存的路徑回報給使用者。若要修改,請以小的單變數步驟迭代,並重新說明不變項(請見 PROMPTING.md)。
輸出位置
若未指定 --out,腳本會自動解析資料夾:
| 條件 | 目標資料夾 |
|---|---|
./public/ 存在(Web/應用程式專案) | ./public/images/ |
| 其他情況 | ./assets/images/(若不存在則建立) |
這能在各專案間建立一致的 assets/images/ 慣例,同時也尊重 Web 專案的需求,在該類專案中圖片必須放在 public/ 下才能被提供。
選項
| 標記 | 效果 |
|---|---|
--out <目錄> | 寫入此目錄而非自動解析的預設目錄 |
--out <檔案>.png | 寫入此確切的檔案路徑 |
--name <基底名稱> | 使用此基底名稱而非將提示詞轉為 slug |
永遠不會覆寫現有檔案:腳本會改為附加 -2、-3…… 等後綴。
交付物命名
這些輸出是工作資產,因此預設會使用簡短的機能名稱。如果圖片是給利害關係人的交付物,請傳遞明確的 --name,並遵循檔案命名規則,例如:
--name "20260612_Hero Banner_v1"
需求
- 已安裝
codexCLI (brew install --cask codex) - 已使用 ChatGPT 帳號登入:
codex login(Plus 或更高版本;免費方案不提供圖片生成)
腳本會檢查上述兩項,並在缺少任一項時顯示明確的錯誤訊息並失敗。