image-gen

name	image-gen
description	图片生成, 架构图, 流程图, 时序图, 泳道图, diagram, architecture, flowchart, sequence, swimlane, image generation, nano banana, 生图, 画图, 画一个, 生成图片, generate image, draw diagram

Image Gen Skill

通用图片生成技能，支持自由生图和结构化图表生成（架构图、流程图、时序图、泳道图）。通过可配置的 API Provider 调用图片生成模型。

Prerequisites

1. Python3 可用。
2. 已配置 API Provider（编辑 ~/.claude/skills/image-gen/providers.json 填入 api_key）。

Script Path

SKILLS_HOME="$HOME/.claude/skills"
SCRIPT="${SKILLS_HOME}/image-gen/scripts/image-gen.py"

Config（配置管理）

查看当前配置

Triggers: "image-gen 配置", "查看生图配置", "image config"

python3 "$SCRIPT" config

切换 Provider

Triggers: "切换生图 provider", "switch image provider"

python3 "$SCRIPT" config --switch <provider_key>

可选 provider_key: huan, undying, google

Generate（自由生图）

Triggers: "生成图片", "画一个", "generate image", "生图", "画图"

直接传入 prompt 生成图片：

python3 "$SCRIPT" generate "一个微服务架构图，包含网关、用户服务、订单服务和数据库"

可选参数：

• --output <path>：指定输出路径（默认 ./images/image-gen-<timestamp>.png）
• --ratio <16:9>：宽高比（默认 16:9）
• --style <clean>：风格 clean / detailed / minimal（默认 clean）

Diagram（图表模式）

根据图表类型自动包装专业 prompt 模板，生成高质量技术图表。

架构图 Architecture

Triggers: "画架构图", "architecture diagram", "系统架构"

python3 "$SCRIPT" diagram --type architecture --input "Client -> API Gateway -> Auth Service, User Service -> PostgreSQL"

流程图 Flowchart

Triggers: "画流程图", "flowchart", "流程"

python3 "$SCRIPT" diagram --type flowchart --input "用户注册流程：输入信息->验证邮箱->创建账号->发送欢迎邮件"

时序图 Sequence

Triggers: "画时序图", "sequence diagram", "时序"

python3 "$SCRIPT" diagram --type sequence --input "Browser->Server: HTTP Request; Server->DB: Query; DB->Server: Result; Server->Browser: Response"

泳道图 Swimlane

Triggers: "画泳道图", "swimlane diagram", "泳道"

python3 "$SCRIPT" diagram --type swimlane --input "前端: 发送请求; 网关: 鉴权转发; 服务: 业务处理; 数据库: 读写数据"

从文件读取描述

python3 "$SCRIPT" diagram --type architecture --file description.txt

Diagram 通用可选参数

• --output <path>：指定输出路径（默认 ./images/image-gen-<timestamp>.png）
• --ratio <16:9>：宽高比（默认 16:9）
• --style <clean>：风格 clean / detailed / minimal（默认 clean）

输出约定

脚本成功后会输出图片文件路径，使用 Read 工具查看图片内容展示给用户。

Important Notes

• 首次使用前需编辑 ~/.claude/skills/image-gen/providers.json 填入 api_key。
• 默认使用 Huan API + nano-banana-pro 模型。
• 生成的图片默认保存到当前工作目录的 ./images/ 目录。
• 支持 OpenAI 兼容格式和 Google Gemini 原生格式两种 API 协议。