Gemini Skill

⚠️ 操作优先级（必须遵守）

与 Gemini 的一切交互，按以下优先级选择方式：

1. 🥇 首选：调用 MCP 工具, 直接调用本 Skill 暴露的 MCP 工具完成操作，覆盖绝大多数场景
2. 🥈 次选：运行 Skill 脚本, 当 MCP 工具无法满足需求时，可运行本 Skill 项目中提供的脚本来完成
3. 🥉 最次：连接 Skill 管理的浏览器, 仅当前两种方式都无法解决时，可通过 gemini_browser_info 获取 CDP 连接信息，主动连接到本 Skill 管理的浏览器进行操作。此方式必须先征得用户同意

绝对禁止：自行启动新的浏览器实例访问 Gemini 页面（如使用 OpenClaw 浏览器、另起 Puppeteer 等），这会导致会话冲突。

浏览器 Daemon 未运行时 MCP 工具会自动拉起，无需任何手动操作。

📡 进度同步 & 长耗时工具规则

MCP 工具调用（尤其是生图、等待回复等）可能耗时较长（60~180 秒）。必须遵守以下规则：

• 本 Skill 所有 MCP 工具均为同步阻塞调用，会等到最终结果才返回。不存在"中间状态"需要轮询。
• 调用长耗时工具时，timeoutMs 必须设为 ≥180000（3 分钟），避免传输层提前超时截断。
• 禁止在未收到工具最终返回前结束对话或向用户报告"还在运行"/"工具超时"。
• 每隔 15~30 秒向用户发送一条进度消息（如"正在等待 Gemini 生成图片…已等待 30 秒…"），保持反馈。
• 拿到最终结果后立即回传产物（文件路径）或报告错误，不得遗漏。
• 若 fullSize 模式失败，可降级重试 fullSize=false（预览图模式更稳定）。

触发关键词

• 生图任务：生图、画、绘图、海报、nano banana、nanobanana、image generation、生成图片
• 若请求含糊，先确认用户是否需要生图

使用方式

本 Skill 通过 MCP Server 暴露工具，AI 直接调用即可。

浏览器启动、会话管理、图片提取、文件保存等流程已全部封装在工具内部。

⚠️ 强制规则

AI 必须始终通过 MCP 工具完成所有操作。

禁止绕过 MCP 自行编写临时脚本（如 node -e "..." 或创建 .js 临时文件）来 import / require 本项目导出的函数（如 createGeminiSession、createOps 等）。

如果 MCP 工具确实无法满足当前需求，AI 必须先向用户说明原因并获得明确同意， 才能编写临时脚本调用底层 API。未经用户同意，一律禁止。

可用工具

核心生图（封装完整流程）：

工具名	说明	入参
gemini_generate_image	完整生图流程：新建会话→发prompt→等待→提取图片→保存本地（耗时约 60~120 秒）	prompt，newSession（默认false），referenceImages（参考图路径数组），fullSize（默认true，高清原图；false则预览图），timeout（默认120000ms）

会话管理：

工具名	说明	入参
gemini_new_chat	新建一个空白对话	无
gemini_temp_chat	进入临时对话模式（不保留历史记录）	无

模型切换：

工具名	说明	入参
gemini_switch_model	切换 Gemini 模型	model（pro / quick / think）

文本对话：

工具名	说明	入参
gemini_send_message	发送文本消息并等待回答完成，直接返回 Gemini 的回复文本	message，timeout（默认120000ms）

图片操作：