GPT-Image2-Skill

环境要求

• uv（提供 uvx 与 uv tool 命令，用于运行/安装 CLI）
• git（手动克隆仓库安装 Agent Skill 时需要）
• OPENAI_API_KEY 环境变量（README 会检查是否已设置）
• 支持 Agent Skill 的运行时（Claude Code、Codex、opencode、openclaw 等）之一

安装与启动步骤

1. 1检查已有安装

   安装前先确认是否已存在 gpt-image 命令、已安装的 CLI 或已设置的 OPENAI_API_KEY，避免重复安装和覆盖。

   command -v gpt-image || true
   command -v uv >/dev/null && uv tool list | grep -E '^gpt-image-cli([[:space:]]|$)' || true
   test -n "${OPENAI_API_KEY:-}" && echo "OPENAI_API_KEY is already set (value hidden)"

   复制

2. 2Claude Code 安装技能

   在 Claude Code 中依次执行两条斜杠命令，把插件市场加入后安装 gpt-image 技能。

   /plugin marketplace add wuyoscar/gpt_image_2_skill
   /plugin install gpt-image@wuyoscar-skills

   复制

3. 3Codex 安装技能

   用 npx 调用 skills 安装器，可按需增减 --skill；--agent 可改为 claude-code、codex、opencode 等运行时。

   npx --yes skills@latest add wuyoscar/gpt_image_2_skill \
     --skill gpt-image \
     --skill get-prompt-from-image \
     --agent codex --copy

   复制

4. 4手动软链安装技能

   其他运行时先克隆仓库，把 AGENT_SKILLS_DIR 指向该运行时的技能目录，再软链技能文件夹；目录已存在时会中止以免覆盖。

   git clone https://github.com/wuyoscar/gpt_image_2_skill.git
   cd gpt_image_2_skill
   export AGENT_SKILLS_DIR="/path/to/your/agent/skills"
   mkdir -p "$AGENT_SKILLS_DIR"
   for skill in gpt-image get-prompt-from-image; do
     test -e "$AGENT_SKILLS_DIR/$skill" && echo "$skill already exists; stop before overwriting" && exit 1
     ln -s "$PWD/skills/$skill" "$AGENT_SKILLS_DIR/$skill"
   done

   复制

5. 5直接运行 CLI

   无需安装，用 uvx 从 Git 仓库临时拉取并执行 gpt-image 生成图片，-p 后接提示词。

   uvx --from git+https://github.com/wuyoscar/gpt_image_2_skill gpt-image --model gpt-image-2.5-flare -p "a cat astronaut"

   复制

6. 6安装 CLI 到 PATH

   如果 gpt-image 命令尚未安装，则用 uv tool install 装到 PATH，之后可直接调用。

   command -v gpt-image >/dev/null || uv tool install git+https://github.com/wuyoscar/gpt_image_2_skill
   gpt-image --model gpt-image-2.5-flare -p "a cat astronaut"

   复制

关键配置

如何确认成功

执行 `gpt-image --model gpt-image-2.5-flare -p "a cat astronaut"` 能正常产出图像；或在运行时技能列表中看到 gpt-image 与 get-prompt-from-image。

常见问题

注意事项

• 安装前先用 README 给出的检查命令确认是否已存在 skill 或 CLI，避免重复安装。
• README 的安装示例刻意不加 --global，只有在确实想写入全局/共享技能目录时才加。
• 手动软链方式会保留原有技能文件夹和 API Key 文件，脚本遇到同名技能会主动中止。
• CLI 示例统一使用 --model gpt-image-2.5-flare，可按需替换为其他模型名。