用途:为 GitHub 仓库生成社交预览图(Open Graph 图片),用于在 Twitter、LinkedIn、Slack、Discord 等平台分享仓库链接时展示。
主要能力:依赖 nano-banana-pro 技能进行图像生成,可输出符合 GitHub 规范的预览图。GitHub 规范:最小 640×320 像素,推荐 1280×640,宽高比 2:1,支持 PNG/JPG/GIF,最大 1MB,仅 PNG 支持透明。
使用方式:需设置 GOOGLE_API_KEY 或 GEMINI_API_KEY,安装依赖 pip install google-genai Pillow(或使用 uv run)。生成命令示例:uv run python .claude/scripts/nano_banana_pro.py "提示词" --aspect 16:9 --resolution 2K --output social-preview.png。支持 --reference 传入品牌图做风格迁移。生成后用 magick identify 检查尺寸,用 magick 调整到 1280x640 并优化到 1MB 以内,再在仓库 Settings 的 Social preview 区域上传。
适用场景:创建或更新仓库社交预览图、生成文档用项目缩略图、为 GitHub Pages 生成 Open Graph 图片。
限制:不适用于任意文生图(应直接用 nano-banana-pro)、不用于调整或优化已有图片(用 imagemagick-conversion)、不用于复杂插画或像素级排版、不生成动图 GIF。私有仓库无法分享预览。设计上建议简洁、文字大而清晰、高对比、留 10-15% 安全边距。图片上传后可能需数分钟传播,平台缓存需清理。