前言¶
在 Cursor、Claude Code 等 Agent 裏做配圖時，常見做法是臨時寫腳本或手動打開獨立繪圖站點：上下文要來回切換，圖生圖還要自己管參考圖上傳與參數。若希望把「按描述出圖」和「按參考圖改圖」收進同一次對話，需要一個按 Agent Skill 規範封裝、並標明依賴 API Key 的圖片生成 Skill。
下面介紹 SkillHub 社區 Skill GPT - image2（座標 @user_e942ebfc/gpt-image2-pro）：基於 gpt-image-2 模型，支持文生圖與圖生圖，頁面描述爲開箱即用。
這是什麼¶
GPT - image2 是 SkillHub 上的 design-media 類社區 Skill，當前版本 v1.0.9，發佈者爲 user_e942ebfc，來源標註爲 community。
一句話定位：在 Agent 側提供 AI 圖片生成能力，底層模型爲 gpt-image-2，支持 文生圖 與 圖生圖。Skill 標籤包含 requires_api_key=true，使用前需自行準備並配置模型服務所需的 API Key（具體變量名與配置步驟以安裝包內 SKILL.md 爲準，本文不臆造字段名）。
官方頁面：
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_e942ebfc/gpt-image2-pro
- API 入口（資料中的官方地址）：https://api.skillhub.cn/user_e942ebfc/gpt-image2-pro
截至資料抓取時，頁面側統計爲評分 100000、下載 34893 次（SkillHub 統計會隨時間變化，以官網爲準）。
核心功能¶
以下能力均來自 SkillHub 簡介與元數據，未做擴展：
- 文生圖：根據自然語言描述生成圖片。
- 圖生圖：在已有參考圖基礎上，按提示進行生成或改寫（具體交互方式由 Skill 內說明定義）。
- 模型：統一使用 gpt-image-2。
- 集成形態：標準 Agent Skill（SKILL.md 格式），安裝到當前 Agent 的 skills 目錄後，由 Agent 在合適任務中讀取並執行。
安裝與啓用¶
SkillHub 官方給出的安裝指引分兩種：交給 AI 按文檔安裝，或使用 skillhub CLI。
方式一：提示詞交給 AI¶
將下面意圖發給當前 Agent（與 SkillHub 頁面文案一致）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_e942ebfc/gpt-image2-pro`。
Agent 會按 SkillHub 安裝說明 檢查 CLI、選擇 skills 目錄並執行安裝。
方式二：skillhub CLI¶
若本機已有 skillhub，安裝時必須用 --dir 指向當前 Agent 實際使用的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別；安裝後通常需要重啓或刷新 Agent。
先確認 CLI：
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 文檔執行（完整安裝示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時，將 <skills 目錄> 換成你的環境路徑。SkillHub 文檔中常見路徑包括：
| 環境 | skills 目錄（文檔列舉） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
示例（Cursor）：
skillhub install user_e942ebfc/gpt-image2-pro --dir ~/.cursor/skills/
座標在頁面上寫作 @user_e942ebfc/gpt-image2-pro；CLI 搜索與安裝時使用 user_e942ebfc/gpt-image2-pro 這一形式即可（與 SkillHub 第三節示例一致）。
API Key¶
元數據標籤 requires_api_key=true 表示本 Skill 依賴外部 API。安裝完成後，請打開技能目錄下的 SKILL.md 及附帶說明，按發佈者要求配置 Key；未配置時，生成請求無法正常完成。
典型用法¶
公開頁面未附帶獨立的長篇教程，可復現的流程如下。
- 按上一節完成安裝，並配置 API Key。
- 重啓或重新加載 Agent，確認 GPT - image2 出現在可用 Skill 列表中。
- 在對話中直接說明任務類型：
- 文生圖：描述畫面主體、風格、構圖等期望；
- 圖生圖：提供參考圖（或說明已有路徑/附件），並寫清希望保留或修改的部分。 - Agent 讀取 SKILL.md 中的步驟調用 gpt-image-2；輸出一般爲生成圖片或保存路徑，以 Skill 內定義爲準。
若需覈對參數上限、尺寸、格式等細節，請以安裝包內 SKILL.md 爲唯一依據，本文不列出未在官方摘要中出現的接口字段。
適用場景與注意¶
適合誰
- 已在 Cursor、Claude Code、Codex 等環境使用 Agent，希望把配圖、改圖留在同一對話裏完成的開發者或創作者。
- 已具備 gpt-image-2 對應 API 訪問權限與 Key，並願意按 Skill 文檔做一次性配置的用戶。
限制與注意
- 社區來源（community）：行爲與維護節奏取決於發佈者，升級前可在 SkillHub 查看版本 v1.0.9 是否有更新。
- API 費用與合規：圖片生成走第三方模型 API，用量與計費由 Key 所屬服務決定。
- 安裝目錄：務必
--dir指向當前 Agent 的 skills 路徑，避免「已安裝但 Agent 不加載」。 - 資料範圍：本文功能描述僅對應 SkillHub 簡介；更細的腳本、環境變量、示例命令以安裝後的 SKILL.md 爲準。
結尾¶
GPT - image2 把 gpt-image-2 的文生圖、圖生圖能力封裝成 Agent Skill，適合在 IDE 或 CLI Agent 裏做輕量配圖流程；記得處理 requires_api_key 並完成 skills 目錄安裝。
官方入口：https://www.skillhub.cn/skills/user_e942ebfc/gpt-image2-pro
