用途：BulkGen 是一个用于批量生成 AI 图像的 Agent Skill，适合用户提出“生成一张图”“编辑图片”或一次生成多张图等请求时调用。脚本位于 ~/.claude/skills/bulkgen/scripts/，需使用完整路径。回复用户时应使用用户的语言。
主要能力：支持三种模式——solo（单张图）、variation（同一提示词生成多个风格变体）、batch（每个网格单元使用不同提示词）。可设置网格行列、画布比例、分辨率，并可用 --input 传入参考图进行风格迁移或编辑。
使用方式：先检查环境变量 BULKGEN_API_KEY 是否已设置；若未设置，请用户提供 sk_live_... 格式的密钥（可在 bulk-gen.com 用户菜单的 API Keys 获取），并以行内方式传入，不要导出或持久化。示例：BULKGEN_API_KEY="sk_live_..." node $SCRIPTS/generate.js --prompts "a sunset" --mode solo。生成后应始终运行 build_preview.js 并打开 HTML 预览：node $SCRIPTS/build_preview.js ./bulkgen-result.json ./bulkgen-preview.html && open ./bulkgen-preview.html。仅在用户明确要求时用 download_images.js 下载本地副本。
参数与限制：--mode 可选 solo、batch、variation，默认 variation；--canvas-ratio 支持 1:1、16:9、9:16、4:5、3:4、3:2、2:3、4:3、5:4、21:9，默认 1:1；--resolution 支持 1K、2K、4K，默认 1K。有效布局包括 1x1 至 4x4 的多种组合，画布比例指整个网格而非单个单元，部分布局与比例组合不受支持，脚本会报错并建议替代方案。参考图最多 14 张，每张 7 MB，支持 PNG、JPG、WebP、HEIC、HEIF。图像 URL 12 小时后过期，因此生成后应立即构建预览。错误处理：401 为密钥无效，402 为额度不足，400 为参数无效，500 为服务器错误可重试一次。
适用场景：需要一次生成多张图像、批量探索同一主题的不同风格，或按不同提示词生成独立场景时。
限制：需用户自备 API Key；密钥不得持久化；部分布局与比例组合不可用；生成结果链接有时效。