Banana 是一个将用户意图转化为可控视觉产出的 Claude 技能，通过 Google Gemini 图像模型完成生成、编辑、比较与审查。其工作流程为：先把意图固化为冻结的视觉简报，编译精确提示词，规划请求、取得用户批准，再经内置 Gemini 客户端执行，最后检查实际像素。提示词被视为控制产物，而非成品本身。
【用途与边界】 规划、提示词撰写、模型检查与成本估算不会调用 Google；规划会在本地私有状态写入一份短时有效的批准能力。每次付费调用前必须展示精确计划并获得用户明确批准，批准 ID 为一次性能力，30 分钟后失效，且在尝试前即被消耗。绝不请求、打印、置于命令行或写入 API 密钥。插件配置将密钥作为敏感用户配置提供；独立脚本只读取 GEMINI_API_KEY。重试、修复、续作或重新生成均属新的付费尝试，需重新规划并批准，不会静默自动重试。
【操作类型与按需读取】 先对操作分类：advise、generate、edit、continue、portfolio、typeset、preset、cost 或 doctor，仅在缺失答案会实质影响图像、安全或批准时提一个问题。按需读取参考文档：模型与路由读取 references/gemini-models.md，简报与提示词技巧读取 references/prompt-engineering.md，工具 schema 与批准绑定读取 references/mcp-tools.md，价格与账本读取 references/cost-tracking.md 等。
【视觉简报】 使用版本化的 banana.visual-brief.v1 契约，规划器对对象做规范化、计算 brief_sha256，并绑定进每个请求指纹与产物 sidecar。简报字段包括：目标（资产、受众、投放位置、可观察成功标准）、事实与精确文案、锁定与自由度、供给方向、构图与光线、材质与媒介、参考、输出与审查。对于真正简单低风险的一次性生成，可用紧凑的 planner_minimal 简报。
【模型路由】 规划前立即调用 banana_models 或读取模型参考，不凭记忆路由。默认：最低成本草稿或量产 1K 用 gemini-3.1-flash-lite-image；通用生成、编辑、grounding 或视频输入用 gemini-3.1-flash-image；复杂指令、文字、本地化或品牌精度用 gemini-3-pro-image。
【计划、批准、执行】 冻结简报与精确提示词，先无供应商调用地规划，展示 approval_summary（含编译后提示词、brief_sha256、模型、尺寸、比例、尝试次数、名义成本等），再提供完整 trace，说明供应商可能返回不同数量图像且按实际输出计费，最后询问是否执行并等待。获批后不改变任何绑定字段地执行。
【续作与作品集】 仅当用户需要供应商管理的续作并接受披露的保留策略时使用 store: true。作品集仅在比较对决策有意义时使用，最多三个提示词跨三个模型、共九个付费请求、最多三个并发，所有条目须共享同一已验证参考快照。
【文字排版与审查】 对含文字概念，冻结每个字符串并检查每个字形；法律文案、精确标志、批准字体或密集布局先用确定性有序图层。合成器接受文字加受信任的位图标志或艺术图层，拒绝任意源 SVG。SVG 标记不构成渲染像素证据，须以确切交付尺寸渲染 PNG 或 JPEG 后同时提供预览与 SVG 供审查。每次输出后区分传输与视觉审查，返回 Pass、Targeted fix、Regenerate 或 Blocked。
【直接工具】 脚本均与工作目录无关，例如： python3 "$CLAUDE_SKILL_DIR/scripts/generate.py" --prompt "..." python3 "$CLAUDE_SKILL_DIR/scripts/edit.py" --image /path/input.png --reference-name "front product photo" --reference-role object --reference-purpose "preserve geometry" --brief-file /path/brief.json --prompt "..." python3 "$CLAUDE_SKILL_DIR/scripts/portfolio.py" --prompt "..." --model gemini-3.1-flash-image --brief-file /path/brief.json python3 "$CLAUDE_SKILL_DIR/scripts/typeset.py" --image /path/input.png --layers-file /path/layers.json python3 "$CLAUDE_SKILL_DIR/scripts/batch.py" --csv /path/plan.csv CSV 工具仅生成离线变体计划，不提交 Google 异步 Batch API。
【费用与真实性说明】 资料未提供具体收费金额、价格表或平台可用性细节，缺失事实请以实际配置与官方说明为准。