Gemini CLI GitHub Actions

谷歌推出 run-gemini-cli —— 一个开源的 GitHub Action，将 Gemini 模型深度集成到你的开发流程中。

它不只是一个自动化脚本，而是一个可交互、可触发、能执行复杂任务的 AI 协作伙伴。无论是自动审查 PR、分类 Issue，还是即时回答代码问题，你都可以通过一句评论（如 @gemini-cli /review）在 GitHub 仓库中直接调用 Gemini 完成。

更重要的是：免费可用，配置简单，支持高度定制。

它能做什么？

Gemini CLI 可以作为两种角色嵌入你的开发流：

1. 自主代理：基于事件（如新建 Issue）或定时任务自动运行，完成预设工作。
2. 按需助手：在 PR 或 Issue 评论中被提及后即时响应，执行用户指定任务。

典型使用场景

这一切都发生在 GitHub 原生环境中，无需跳出页面，也无需额外工具。

快速上手：三步启用

第一步：获取 Gemini API 密钥

前往 Google AI Studio 获取免费 API 密钥，享有 generous 的使用配额（目前每月数百万 tokens 免费）。

第二步：添加密钥到仓库

进入你的 GitHub 仓库：

Settings > Secrets and variables > Actions > New repository secret

创建名为 GEMINI_API_KEY 的密钥，值为你获取的 API Key。

第三步：选择配置方式

✅ 推荐方式：使用 setup 命令

在本地运行：

gemini

在交互界面中输入：

/setup-github

CLI 会自动生成适配你仓库的工作流程文件。

手动方式：复制预设工作流

从 examples/workflows 目录复制 .yml 文件到 .github/workflows/ 目录下即可。

支持的核心工作流

该 Action 提供了多个开箱即用的工作流模板，均可按需修改：

所有工作流均支持事件驱动与手动触发双模式。

如何调用？就像 @ 一个人

在任意 Issue 或 PR 的评论区，只需写：

@gemini-cli 你的请求

例如：

• @gemini-cli /review —— 请求审查当前 PR
• @gemini-cli explain this change —— 解释某段代码修改
• @gemini-cli suggest better variable names
• @gemini-cli write integration tests for this module

支持自然语言输入，也能识别预定义指令（以 / 开头）。

高级功能与可扩展性

🔧 工具调用能力

Gemini 模型具备调用 CLI 工具的能力，例如结合 gh（GitHub CLI）执行仓库操作，未来可扩展至其他内部工具链。

📂 项目级上下文定制

在仓库根目录创建 GEMINI.md 文件，为 Gemini 提供专属上下文，例如：

• 项目架构说明
• 编码规范
• 常见术语解释

这样 AI 助手的回答会更贴合团队实际。

📊 可观察性支持（可选）

可通过配置将执行日志、追踪和指标发送至 Google Cloud 项目，便于：

• 监控性能
• 调试失败任务
• 分析使用模式

适用于需要审计或优化 AI 行为的企业场景。

🔐 安全认证机制

支持多种认证方式，兼顾灵活性与安全性：

建议在正式项目中使用 自定义 GitHub App + WIF 实现最小权限控制。

配置参数一览

建议通过 仓库变量 统一管理版本、区域等公共配置，提升维护效率。