用途：在用户要求用 Luma AI API（Dream Machine / Photon）生成图像时使用，支持文生图、参考图引导风格或结构、以及基于 modify_image_ref 修改或风格化已有图像。
主要能力：检测 LUMA_API_KEY；交互式收集提示词、宽高比、模型与参考图；将描述整理为结构化提示词；调用捆绑的 scripts/luma_imagegen.py 执行生成；自动异步轮询至 completed；显示结果 URL 并下载到 output/luma/。
使用方式：先运行 python3 ${CLAUDE_SKILL_DIR}/scripts/luma_imagegen.py --check-key 检查密钥。若缺失，引导用户到 https://lumalabs.ai/dream-machine/api/keys 生成，并在本地 .env 或 shell 中设置 export LUMA_API_KEY=your_key_here，不要让用户在对话中粘贴密钥。随后执行：python3 ${CLAUDE_SKILL_DIR}/scripts/luma_imagegen.py --prompt "..." --aspect-ratio 16:9 --model photon-1 [--image-ref URL --image-ref-weight 0.85] [--out output/luma/]。常用参数：--aspect-ratio 默认 16:9，可选 1:1、3:4、4:3、9:16、16:9、9:21、21:9；--model 默认 photon-1，可选 photon-flash-1；--modify-ref 与 --modify-ref-weight 默认 0.5；--poll-interval 默认 3 秒。
适用场景：生成主视觉、产品图、社交配图等；用参考图保持风格或角色一致性；对已有图做局部修改。建议先用 photon-flash-1 快速迭代，再用 photon-1 出最终质量；每次迭代只做一处针对性修改。
限制：需自备 Luma API 密钥；脚本仅用 Python 标准库，无额外依赖；输出目录相对于调用时的工作目录；失败时展示 API 返回的 failure_reason。资料未提供具体收费与价格信息。