TGW Image 生图是一个作为 TGW Image 生图执行入口的 Skill，只负责用本机系统 imagegen CLI 调用 gpt-image-2 生成可验收的位图图片资产。
用途 该 Skill 面向位图生图任务，适用于插画、海报、封面、产品图、社媒图、概念视觉和视觉草图等场景。它的默认目标是生成 raster 图片，即 PNG、JPG、WebP 等位图资产。它不接管 SVG、HTML/CSS/canvas 绘图任务。对于 Logo 定稿、SVG 图标、网页组件、图表代码和可编辑矢量，应改用对应代码或设计流程，而不是使用本 Skill。
主要能力与工作流程 使用该 Skill 时，先判断任务是否为位图生图。确认后，执行 python3 scripts/check_image2_env.py --json 检查环境；如果缺少 API Key，则只输出配置引导，不生成。环境可用后读取 references/image2-cli.md。随后把用户需求整理成结构化提示词，至少包含用途、主体、风格/媒介、构图、光线/情绪、颜色以及约束和避免项。输出路径方面，用户指定路径优先使用，但不得位于 Skill 包目录内；未指定时使用 tgw-exports/imagegen/YYYYMMDD-HHMM-简短文件名.png。生成通过 scripts/image2_generate.py 运行系统脚本完成，不会把 Key 直接拼进命令。生成完成后必须验收，包括检查文件是否存在、类型是否正确、大小是否合理，记录实际尺寸，并进行视觉检查。验收命令为 file "<输出图片路径>" 和 ls -lh "<输出图片路径>"。能视觉检查时打开或展示图片；不能视觉检查时说明只完成了文件级验收。最终只报告保存路径、实际文件信息、实际尺寸、是否符合提示词以及是否需要重试。
使用方式 用户可以通过 /TGW-image、/TGW-image-init、/TGW-image-check、/TGW-image-generate 等指令调用。首次使用需要先检查 API 环境；缺少 OPENAI_API_KEY 时停止，不要假装已经生成。OPENAI_BASE_URL 必须是 OpenAI 兼容的 /v1 地址，默认推荐 https://cc.codesome.ai/v1。真实 API Key 只允许来自当前 shell 环境、macOS Keychain 或用户临时输入，不得写进 SKILL.md、README、脚本、项目 Markdown、Git 仓库或命令示例。用户通过 /TGW-image-init 明确配置时，才可把粘贴的 Key 写入 macOS Keychain；普通生图请求里临时贴 Key 时，只可用于当前调用，不写入项目文件、命令历史、日志或仓库。首次配置时，如果用户输入 /TGW-image-init 并贴出 OPENAI_API_KEY、OPENAI_BASE_URL、Codex TOML 配置或 JSON 配置，可直接执行 python3 scripts/configure_image2_api.py，把用户贴的完整配置原文作为 stdin 传入，不把 Key 拼进 shell 命令、命令参数、临时文件或日志。初始化器会自动把 https://cc.codesome.ai 规范成 https://cc.codesome.ai/v1，并把 Key 和 Base URL 写入 macOS Keychain。写入后必须运行 python3 scripts/check_image2_env.py --json，只有返回 status: configured 才说明配置完成。
适用场景 该 Skill 适用于用户明确要求 TGW Image 生图、Image2 生图、gpt-image-2 生图，或通过 /TGW-image、/TGW-image-init、/TGW-image-check、/TGW-image-generate 调用时的位图生成需求。它也适用于需要检查生图配置是否可用、首次配置生图 API 等场景。生成物默认写入运行项目的 tgw-exports/imagegen/ 目录，不会写入 Skill 包目录。
限制与约束 该 Skill 默认只封装 gpt-image-2 生图；当用户要求编辑已有图片、透明背景或复杂抠图时，会说明需要编辑或透明专用路径时转回系统 imagegen Skill 的对应流程。它复用系统脚本，不复制也不修改系统 image_gen.py。不得把真实 API Key 写入任何仓库文件、shell profile 或命令示例，不在 README、资产卡、日报或导出包里保存 API Key，不把缺 Key 的失败说成“模型不可用”，不把 Codex 对话模型配置当成 Image API 配置，不默认使用 gpt-image-1.5 替代 gpt-image-2，不承诺像素级精确构图、文字 100% 正确或尺寸一定等于请求尺寸，也不把生成物默认保存到 Skill 包目录。如果用户要求严格尺寸，生成后发现尺寸不一致，必须说明实际尺寸；必要时用本地工具二次缩放，不隐瞒。