7.3 KiB

Raw Permalink Blame History

GPT Image 2 Skill

面向 GPT Image 2 的聚焦型图像生成 / 编辑技能。一份 SKILL 定义，自动适配三种运行环境——本地直接出图、宿主原生图像工具、纯提示词顾问。

这个 Skill 干什么

围绕 GPT Image 2（以及任何 OpenAI 兼容的图像接口）做的结构化提示词工程 + 图像生成包。只做两件事——POST /images/generations 和 POST /images/edits，但能在三种完全不同的运行环境下做到对用户无感。

它内置了：

模式感知工作流：无论 Agent 自己持有 API key、宿主带原生图像工具、还是完全没有图像工具，同一份 Skill 都能用。
结构化模板库：18 大类、70+ 个提示词模板，覆盖海报、UI 样机、产品图、信息图、学术图、技术架构图、漫画、头像、编辑工作流。
可复用的 prompt + 图片归档：默认落盘到 garden-gpt-image-2/prompt/ 和 garden-gpt-image-2/image/，按 <task-slug>-<timestamp> 命名。

三种运行模式

任何任务的第一步都是跑这个探测脚本：

node skills/gpt-image-2/scripts/check-mode.js
# 想拿结构化结果：
node skills/gpt-image-2/scripts/check-mode.js --json

输出会判定为以下三种之一：

模式	触发条件	行为
A · Garden 本地生图	`ENABLE_GARDEN_IMAGEGEN` 为真且有 `OPENAI_API_KEY`	端到端：选模板 → 渲染 prompt → 调用 `generate.js` / `edit.js` → 图片落盘
B · Host-Native 委托宿主出图	未启用 Garden，但宿主 Agent 自带图像工具（`image_generation` / `dalle` / `nano_banana` / 图像 MCP 等）	渲染好 prompt 后交给宿主自带的图像工具出图
C · Advisor 纯提示词顾问	未启用 Garden，宿主也没有图像工具	退化成"高质量 prompt 撰写顾问"——把 prompt 落盘到 `garden-gpt-image-2/prompt/`，告诉用户去 ChatGPT / Midjourney / DALL·E / Sora / Nano Banana / 自己的网关里执行

三种模式都建议落盘 prompt 文件（A、C 必须，B 推荐），但只有 A 会产出图片文件——B 由宿主决定，C 不可能。

快速上手

0. 检测运行模式（永远是第一步）

node skills/gpt-image-2/scripts/check-mode.js

下面 1~4 仅在 Mode A 下使用。

1. 文本生图

node skills/gpt-image-2/scripts/generate.js \
  --prompt "A cute baby sea otter" \
  --size 1024x1024 \
  --quality high

2. 用提示词文件生图

node skills/gpt-image-2/scripts/generate.js \
  --promptfile garden-gpt-image-2/prompt/poster-20260424-153045.md

3. 编辑已有图片

node skills/gpt-image-2/scripts/edit.js \
  --image assets/source.png \
  --prompt "Replace the background with a clean studio scene"

4. 带遮罩的局部编辑

node skills/gpt-image-2/scripts/edit.js \
  --image assets/source.png \
  --mask  assets/mask.png \
  --prompt "Replace only the masked area with a glass vase"

Mode B / C 没有 CLI 入口——Skill 只负责把最终 prompt 渲染好，然后交给宿主图像工具（B）或直接呈现给用户（C）。

Skill 结构

skills/gpt-image-2/
├── SKILL.md                       主技能定义
├── scripts/
│   ├── check-mode.js              模式 A/B/C 探测器（先跑这个）
│   ├── generate.js                文本生图（仅 Mode A）
│   ├── edit.js                    图像编辑 / 局部编辑（仅 Mode A）
│   ├── shared.js                  共享请求 / 落盘 / 环境变量解析
│   └── package.json
└── references/
    ├── prompt-writing.md          方法论：模板怎么设计、缺字段怎么问
    ├── ui-mockups/                直播带货、社交、产品卡、聊天、短视频封面
    ├── product-visuals/           爆炸图、纯白底、影棚、包装、生活方式
    ├── infographics/              信息图
    ├── poster-and-campaigns/      品牌主海报、Campaign KV、banner、杂志封面
    ├── slides-and-visual-docs/    高密度讲解、政策风、商业报告、教学示意
    ├── portraits-and-characters/  职业肖像、创始人肖像、虚拟主播、角色设定
    ├── scenes-and-illustrations/  治愈系、概念大场景、绘本、极简留白
    ├── editing-workflows/         背景替换、局部替换、去除、产品精修、人像编辑
    ├── avatars-and-profile/       风格化自拍、角色网格、3D 图标、贴纸、文化系列
    ├── storyboards-and-sequences/ 4 格漫画、漫画分镜、动漫 KV、角色关系图、流程图
    ├── grids-and-collages/        2×2 banner、lookbook、混风格拼贴、动漫 pitch board
    ├── branding-and-packaging/    品牌识别系统、吉祥物、化妆品包装、饮料标签
    ├── typography-and-text-layout/ 大字海报、双语版式
    ├── assets-and-props/          拟物图标、游戏截图样机
    ├── academic-figures/          方法 pipeline、神经网络架构、定性对比
    ├── technical-diagrams/        架构图、流程图、时序图
    └── maps/                      美食地图、旅行路线图、城市插画、门店分布

环境变量

按以下顺序读取：CLI 参数 → process.env → <cwd>/.env → <cwd>/.gateway.env → ~/.gateway.env。

变量	必需性	说明
`ENABLE_GARDEN_IMAGEGEN`	Mode A 必需	模式开关：`1` / `true` / `yes` / `on` 启用 Mode A
`OPENAI_API_KEY`	Mode A 必需	真正调图像 API 用
`OPENAI_BASE_URL`	可选	默认 `https://api.openai.com/v1`，可指向任意 OpenAI 兼容网关
`OPENAI_IMAGE_MODEL`	可选	默认 `gpt-image-2`，也可换成 `gpt-image-1` / `dall-e-3` 等

默认实现严格按 OpenAI 兼容接口工作，不绑定任何第三方网关。

输出约定

如果用户没有明确指定输出路径：

内容	落盘位置	适用模式
渲染好的 prompt	`garden-gpt-image-2/prompt/<task-slug>-<timestamp>.md`	A / B / C
生成的图片	`garden-gpt-image-2/image/<task-slug>-<timestamp>.png`	仅 A（B 由宿主决定，C 不产出）

<task-slug> 由用户请求自动派生，<timestamp> 是 YYYYMMDD-HHMMSS。

示例：

garden-gpt-image-2/prompt/live-commerce-ui-20260424-153045.md
garden-gpt-image-2/image/vr-headset-exploded-view-20260424-153102.png

设计原则

先判模式，再干活。 不会因为宿主没 API key 就静默失败，而是优雅地降级到 B / C 并明确告知用户当前状态。
模板优于自由提示。 18 大类预校验过的结构化模板，带显式 {argument ...} 参数槽和 default 标记，质量远高于"你说说想要啥"。
精确提问，不要笼统提问。 模板字段缺失时按字段精确问（"主播是谁？真人照片 / 名人名字 / 自由描述 / 随机生成？"），不要笼统问"想要什么风格"。
永远归档 prompt。 即使在顾问模式，渲染好的 prompt 也会落盘，方便复用。
默认 OpenAI 兼容。 不锁定任何特定网关。

许可证

MIT

7.3 KiB Raw Permalink Blame History Unescape Escape