图像与绘图
auto-draw-plot
根据用户描述生成高质量绘图 prompt,并按通用、roadmap、schematic 模式通过 BenszAPI 直接完成 gpt-image-2 或 Nano Banana/Gemini 出图、编辑和多轮迭代;这是自包含的图片生成工作流,选中后不得调用或依赖 imagegen,除非用户明确要求同时使用 imagegen。
huangwb8 · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add huangwb8/skills --skill auto-draw-plot技能说明
name: auto-draw-plot description: 根据用户描述生成高质量绘图 prompt,并按通用、roadmap、schematic 模式通过 BenszAPI 直接完成 gpt-image-2 或 Nano Banana/Gemini 出图、编辑和多轮迭代;这是自包含的图片生成工作流,选中后不得调用或依赖 imagegen,除非用户明确要求同时使用 imagegen。 metadata: author: Bensz Conan short-description: 模式化需求理解 + multi-round image-to-image optimization + gpt-image-2 低成本 JPEG keywords: - auto-draw-plot - nano-banana - gemini - parallel-vibe - visual evaluation - 图像生成
Auto Draw Plot
BenszAPI 任务工作区
本 Skill 的新任务中间文件统一写入 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/{skill名}/input|output|log/。同一任务复用一个任务根目录;多 Skill 协作才创建 shared/。正式交付物不写入该目录,历史隐藏目录只允许显式兼容读取、迁移或清理。
与 bensz-collect-bugs 的协作约定
- 如果用户环境里出现因本 skill 设计缺陷导致的 bug,先用
bensz-collect-bugs规范记录到~/.bensz-skills/bugs/,禁止直接修改用户本地 Claude Code/Codex 已安装的 skill 源码。 - 只在用户明确要求“report bensz skills bugs”时,才通过本地
gh调用将新 bug 推送到huangwb8/bensz-bugs;上传前必须先脱敏本地路径/用户名等隐私。
定位
- 以用户需求为起点,由宿主 AI 进行语义规划,再构造适用于当前图片 provider 的 prompt;脚本默认不调用额外 Gemini 文本接口。
- 默认模式是
general;用户明确要技术路线图/roadmap/flowchart 时使用roadmap,明确要原理图/机制图/架构图时使用schematic。后续新增类型应作为config.yaml:modes.presets扩展,不改主流程。 - 默认通过
scripts/run_draw_plot.py在独立隐藏工作区里完成“parallel-vibe 规划留痕 → prompt → 出图 → 视觉评估 → 继续/停止”的闭环;parallel-vibe是必选工作流的一部分,不是可选增强。 - 默认工作区是当前目录下的
.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/auto-draw-plot/{yyyy-mm-dd-hh-mm}/;所有中间文件必须留在隐藏目录里。宿主 AI 在正式检查 API、初始化工作区或开始出图前,必须先向用户明确声明本次任务.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/auto-draw-plot根目录的绝对路径,方便用户实时监督。轻量测试目录固定为./tests/draw-plot。
技能边界
auto-draw-plot独立负责需求拆解、prompt 生成、图片 generation/edit、多轮保真微调、评估与交付;图片请求由本 skill 的脚本通过 BenszAPI 提交,不调用也不依赖imagegenskill。- 用户要求用
auto-draw-plot画图、改图或基于上一轮继续微调时,只使用本 skill 完成完整链路。不得把它表述或编排为“先生成 prompt,再交给imagegen出图/编辑”的前处理步骤;这种说法会错误暗示依赖关系,并可能造成重复生图与重复计费。 - 只有用户明确点名同时使用
imagegen,或明确要求其独有能力时,才允许额外调用imagegen;调用前说明两者各自独立的职责,且不得将imagegen伪装成auto-draw-plot的内部依赖。 - 默认用户可见说明应写明:
本次使用 auto-draw-plot,由其经 BenszAPI 完成 prompt、出图和后续编辑。不得默认承诺后续会调用imagegen。
输入
user_need(必需):自然语言描述的图像需求、输出用途、必要的视觉语义与格式要求。mode(可选):general/roadmap/schematic;默认general。模式只改变 prompt preset、默认画布和评估口径,不引入 legacy draw.io 渲染器。api_config(可选):指向~/.bensz-skills/config/remote.env的路径;默认auto只在运行前按优先级选择连接与鉴权检查通过的 provider,真实生成资格以 Images submit 响应为准。image_provider(可选):用户明确指定的图片模型/provider,如gpt-image-2或nano_banana。显式指定后必须只用该 provider,失败时暂停并报告原因,不得切换到其他模型。allow_provider_fallback(可选):只有用户明确说“失败可以换模型/可以回退到另一个 provider”时才为 true;该授权仅覆盖已确认未创建任务的 provider 故障,不覆盖订阅、余额、权限、overage、计费服务错误或 submit 空/非 JSON 等任务创建状态不确定的协议错误。max_rounds(可选):最大优化轮数,默认 3;若用户另有指定,以用户为准。visual_constraints(可选):比例、期望布局、色调、字体等硬约束。尺寸只作为 provider 原生尺寸选择参考,不承诺最终导出像素。quality/provider_size/output_format/output_compression(可选):gpt-image-2显式 provider 参数;默认分别为low、1024x1024、jpeg、85,均执行白名单或范围校验。reference_images(可选):用于 prompt 引导的风格/布局图;第 2 轮起上一轮output.jpg会自动作为第一参考图,用户参考图排在其后。workspace_base(可选):用户显式指定的隐藏工作区根目录;未指定时使用当前目录.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/auto-draw-plot/。
输出
- 至少 1 张合乎需求的图像;
gpt-image-2正式输出默认为jpeg。 - 隐藏目录里的
meta/analysis.json/meta/result.json:记录每轮 prompt、模型参数、参考图策略、评估结果、最终选图和停止原因。 - 每轮图片 meta 必须区分
requested_provider_size、native_size、output_size与postprocess_resize_applied;默认postprocess_resize_applied=false。 image-debug/gpt-image-2-error.json只保留错误类别、HTTP 状态和服务端安全返回的error.type/error.code/error.message。JSON 与 multipart 请求发送安全X-Client-Request-ID;2xx空正文或非 JSON 正文分别记录PROVIDER_EMPTY_RESPONSE/PROVIDER_NON_JSON_RESPONSE,附经白名单校验的request_id/client_request_id、origin/path、响应类型、声明/实际长度、SHA-256、首字节类别和重定向布尔值;不得写入 query、Authorization、API Key、Cookie、prompt、原始正文、订阅明细或原始内部错误对象。- 每轮目录:
rounds/round-XX/prompt.txt、rounds/round-XX/prompt-plan.json、rounds/round-XX/parallel-plan.json、rounds/round-XX/output.jpg、rounds/round-XX/evaluation.json以及image-debug//evaluation-debug/;gpt-image-2默认主动使用 Sub2API image job endpoint,generation/edit 均显式发送quality=low、原生尺寸和output_format=jpeg,并在 debug meta 中保留参考图 SHA-256。 - run 级
parallel-vibe/parallel-plan.json与parallel-vibe/parallel-plan.round-XX.json:每轮必留痕的 parallel-vibe plan。
运行前检查
- 先解析本次任务的隐藏工作区根目录:若用户传入
workspace_base,解析该路径;否则使用project_root/.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/auto-draw-plot。必须把解析后的绝对路径用可见消息告诉用户,例如:本次 auto-draw-plot .bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/auto-draw-plot 工作区绝对路径:/abs/project/.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/auto-draw-plot。这条消息必须出现在 API 检查、init_workspace.py、run_draw_plot.py或任何图片生成调用之前;不要只把路径写进run-manifest.json。 - 默认优先读取本地 Codex 配置:从
~/.codex/config.toml获取 BenszAPI base URL,从~/.codex/auth.json获取OPENAI_API_KEY | OPENAI_API,再使用gpt-image-2;环境变量与remote.env只作为缺失字段的兜底来源。Windows 同时兼容%USERPROFILE%、%HOMEDRIVE%%HOMEPATH%与 Git Bash/PowerShell 的HOME。 - 配置加载必须记录实际配置文件路径、来源和 API Key 不可逆短指纹;若 Codex 配置与 BenszAPI 环境变量同时存在且 Base URL/API Key 不一致,必须在发图前停止并报告冲突字段,不得静默使用旧配置。诊断证据不得写入完整密钥。
gpt-image-2只能绑定benszresearch.com子域名 base URL;非 HTTPS、裸域、非白名单域名或缺少 key 时不得绕过校验。若配置只提供子域名根地址,客户端会在校验后统一规范为带/v1的 API 基址,避免 Images 请求落入站点 HTML fallback。- 如果用户点名
gpt-image-2、Nano Banana、Gemini或其他具体 provider,运行前检查和后续出图都必须固定在该 provider;失败时输出可执行的配置/额度/端点错误,不自动切到另一个模型。 - 只有用户主动要求允许回退时,才设置
allow_provider_fallback=true或脚本参数--allow-provider-fallback;回退路径使用~/.bensz-skills/config/remote.env中的GEMINI_BASE_URL、GEMINI_API | GEMINI_API_KEY、GEMINI_MODEL。即使已授权,计费、订阅、余额、权限、overage、BILLING_SERVICE_ERROR与 submit 空/非 JSON 等任务创建状态不确定的协议错误仍必须停在原 provider 并展示结构化错误。 - 再运行
scripts/nano_banana_check.py。默认auto会按 provider 优先级检查配置、连接和鉴权;若用户指定 provider,应把--provider <name>传给主脚本。/v1/models成功只能表述为connectivity/authentication_ok,不得写成“可生图”或generation_eligible=true;真实 Images submit 才是当前请求的准入判断。
工作流
- 理解需求与模式:宿主 AI 先把用户需求拆成“主体 / 结构 / 风格 / 硬约束 / 禁止项”,并解析
mode;未指定时用general。需要时参考references/prompt-guidelines.md。 - 声明监督路径:在正式