SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场omega-gemini-cli

omega-gemini-cli

智能体与模型

查看项目

更新于 10-16 04:38

技能介绍

用途

omega-gemini-cli 是 Google Gemini CLI 的无头封装技能，用于在需要时获取 Gemini 的分析视角。适用场景包括：对任意问题获取 Gemini 观点、免费额度 AI 咨询（无 API Key 成本）、由 Gemini 模型进行代码审查、头脑风暴与分析任务、对 Claude 自身回答进行交叉验证、处理受益于 Gemini 上下文窗口的大文件或代码库，以及沙箱执行（通过 Gemini 运行/测试代码）。

主要能力

  • 通过 stdin 向 gemini -p "" --yolo 发送提示词。
  • 免费额度可用，无需 API Key，仅需 Google OAuth。
  • 支持指定模型（短标志 -m 或长标志 --model）。
  • 支持 JSON 输出：成功返回 {"response":"..."}，解析失败返回 {"error":"...","raw":"..."}。
  • 支持代码沙箱模式（--sandbox 或 -s）。
  • 支持 stdin 输入与文件审查（将文件内容嵌入提示词）。
  • 提供可用性检查脚本 verify-setup.mjs。

使用方式

提问：

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "What is the best caching strategy for a Node.js API?"

指定模型：

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Explain async/await" --model gemini-2.5-flash
node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Explain async/await" -m gemini-2.5-flash

JSON 输出：

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "List 5 design patterns" --json

代码沙箱：

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Write and run a fibonacci function" --sandbox
node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Write and run a fibonacci function" -s

Stdin 用法：

echo "Explain recursion" | node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs

文件审查：

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Review this code: $(cat src/auth.ts)"

可用性检查：

node .claude/skills/omega-gemini-cli/scripts/verify-setup.mjs
# Exit 0 = available (Node 18+ and Gemini CLI found)
# Exit 1 = not installed or too old

脚本与标志

脚本：ask-gemini.mjs（核心无头封装，通过 stdin 发送提示词）、parse-args.mjs（参数解析，支持 --model/-m、--json、--sandbox/-s）、verify-setup.mjs（可用性检查，Node 18+，Gemini CLI 通过 PATH 或 npx）、format-output.mjs（输出规范化，JSON 信封处理）。

标志：--model MODEL / -m（Gemini 模型，如 gemini-2.5-flash、gemini-2.5-pro）、--json（机器可读 JSON 输出）、--sandbox / -s（代码执行沙箱模式）。

模型（2026）：gemini-3-pro-preview（最新，能力最高）、gemini-3-flash-preview（最新，更快）、gemini-2.5-pro（稳定，高能力）、gemini-2.5-flash（推荐：更低配额/延迟）、gemini-2.5-flash-lite（最轻、最快、配额占用最低）。

退出码：0 成功；1 错误（CLI 失败、认证问题、--json 下 JSON 解析失败）；9009 Windows 下命令未找到（自动回退到 npx）。

斜杠命令

当安装在含 .claude/commands/ 的项目中时：/analyze（用用户提示词及 @ 文件引用运行无头脚本）、/sandbox（以 --sandbox 运行，执行或测试代码）、/omega-gemini（别名：按需进行分析、沙箱或头脑风暴）、/brainstorm（头脑风暴模式，构建含挑战与可选方法论的提示词）、/omega-gemini-setup（验证 Node 与 Gemini CLI，引导安装与认证，无 MCP）。

响应时间

Gemini CLI 作为子进程运行，包含模型启动时间：简单问答/新闻查询约 2 分钟；代码库或大文件审查约 5–10 分钟。运行长任务前应向用户说明预期。

限制与注意事项

  • 首次使用前必须运行 verify-setup.mjs。
  • 切勿将提示词作为位置参数传给原始 gemini CLI，应使用 ask-gemini.mjs 封装。
  • 必须校验模型参数（Windows 上封装通过正则 ^[a-zA-Z0-9._-]+$ 校验）。
  • 不要假设 gemini 在 PATH 中，封装会自动回退到 npx @google/gemini-cli。
  • 需优雅处理退出码 1 和 9009。
  • 运行前应设置用户对响应时间的预期（通常 2–10 分钟）。

集成说明

认证：通过 gemini 交互式会话一次性完成 Google OAuth（运行一次 gemini 登录）。速率限制：受 Gemini API 配额约束（免费额度对个人使用较宽松）。平台：全跨平台；Windows 使用 shell: true 并校验模型，非 Windows 使用数组参数（无 shell）。npx 回退：PATH 未命中时自动以 npx -y @google/gemini-cli 重试。无超时标志：与其他 omega 封装不同，gemini 封装没有 --timeout-ms。Stdin 传递：提示词始终通过 stdin 发送，以避免 shell 参数长度限制（Windows cmd.exe 8191 字符限制，Linux/macOS 的 ARG_MAX）。JSON 信封：--json 在成功时包装为 {"response":"..."}，失败时为 {"error":"...","raw":"..."}。

要求

  • Node.js 18+ 以运行脚本。
  • Google Gemini CLI（npm install -g @google/gemini-cli）并完成一次性 Google 登录。

记忆协议

工作前：读取 .claude/context/memory/learnings.md。工作后：按需将发现追加到 learnings 或 issues。注意：使用 pnpm search:code 可在整个代码库中发现对此技能代码的引用。