Gemini CLI Agent Skills 指南：安装与使用 Google AI 编程助手

这篇指南教你如何用 Agent Skill 扩展 Google Gemini CLI，实现编程工作流自动化——包括调试、项目管理、SEO 审计等，全在终端里完成。

Gemini CLI 是什么？

Gemini CLI 是 Google 开源的命令行 AI 编程工具，直接在终端调用 Gemini 模型。它和 Claude Code 以及 OpenAI Codex CLI 属于同一类工具——AI 编程代理，能读取项目代码、编辑文件、执行命令，并且遵循 Markdown 格式的指令。

Gemini CLI 用 GEMINI.md 作为指令文件。在项目根目录或 home 目录放一个 GEMINI.md，Gemini CLI 启动时自动加载。这相当于 Claude Code 的 .claude/commands/ 或 Codex CLI 的 AGENTS.md。

核心特性：

• 免费额度： Google 账号登录即可获得每分钟 60 次请求，无需 API Key
• 开源： Apache 2.0 协议，完全可扩展
• Gemini 2.5 Pro： 直接使用 Google 最强的编程模型
• 多模态： 支持文本、图片和文件附件
• 扩展系统： 通过 GEMINI.md 和 Extensions API 加载技能和工具

安装 Gemini CLI

Gemini CLI 需要 Node.js 18 或更高版本。通过 npm 全局安装：

npm install -g @anthropic-ai/gemini-cli

也可以用 npx 免安装运行：

npx @google/gemini-cli

安装后用 Google 账号登录：

gemini auth login

如果需要更高的请求频率，设置 API Key 环境变量：

export GEMINI_API_KEY="your-api-key-here"

验证安装：

gemini --version

看到版本号就可以在任意项目目录运行 gemini 开始使用了。

Gemini CLI 如何加载 Skill

Gemini CLI 按层级加载 GEMINI.md 指令文件，类似 .gitignore 的工作方式：

1. 全局： ~/.gemini/GEMINI.md — 对所有项目生效
2. 项目根目录： ./GEMINI.md — 对当前项目生效
3. 子目录： ./src/GEMINI.md — 在该目录下工作时生效

一个基本的 GEMINI.md 结构：

# Project Instructions

You are working on a Nuxt 3 application with TypeScript.

## Code Style
- Use Composition API with `<script setup>`
- Prefer `const` over `let`
- All components go in `components/`

## Testing
- Run `npm test` before committing
- Write unit tests for all utility functions

## Deployment
- Build with `npm run build`
- Deploy to Vercel with `vercel --prod`

扩展系统允许加载 Markdown 指令之外的工具和能力。在 ~/.gemini/settings.json 中声明扩展：

{
  "extensions": [
    {
      "name": "web-search",
      "enabled": true
    },
    {
      "name": "code-execution",
      "enabled": true
    }
  ]
}

Agent Skill 本质是结构化的 Markdown 文件，教 CLI 如何执行特定任务。写好一个 .md 技能文件，放到 Gemini CLI 能找到的位置，模型就会在会话中遵循这些指令。

从 TokRepo 安装 Skill

TokRepo 是目前最大的 AI 编程助手技能注册中心。大多数 Skill 采用通用 Markdown 格式，可以在 Claude Code、Codex CLI 和 Gemini CLI 之间通用，只需少量适配。

方法一：TokRepo CLI（推荐）

安装 TokRepo CLI，直接拉取 Skill：

npm install -g tokrepo
tokrepo install <skill-uuid> --target gemini

--target gemini 参数会自动转换成 GEMINI.md 格式，放入项目的 .gemini/ 目录。

方法二：手动安装

1. 浏览 TokRepo Skill 集合
2. 复制 Skill 的 Markdown 内容
3. 在项目中创建文件（如 GEMINI.md 或 .gemini/skills/skill-name.md）
4. 粘贴内容，把 Claude Code 相关的引用替换成 Gemini CLI 的等效写法

例如，把 /skill-name 触发模式改成 Gemini 的自然语言调用方式。大部分技能指令（代码规范、测试规则、部署步骤）无需修改即可使用。

Gemini CLI 最佳 8 个 Skill

以下 Skill 均在 Gemini CLI 上测试过，按实用性、兼容性和社区采用度排序。每个都是 Markdown 文件，30 秒内可安装。

1. Gemini CLI Extension Stitch

做什么： 将 Stitch 设计系统集成到 Gemini CLI，在终端内直接生成 UI 组件、应用 Design Token，保持项目视觉一致性。

适合谁： 需要 AI 辅助设计转代码工作流的前端开发者。

tokrepo install c4b18aeb --target gemini

在 TokRepo 查看 →

2. Google Gemini CLI Extensions

做什么： 官方和社区扩展合集——文件搜索、网页浏览、代码执行沙箱、多仓库上下文加载等能力。

适合谁： 想充分释放 Gemini CLI 扩展生态的进阶用户。

tokrepo install b9520bd2 --target gemini

在 TokRepo 查看 →

3. Gemini CLI Extension Workspace

做什么： 在 Gemini CLI 中管理多项目工作区。切换仓库、维护独立上下文、跨项目执行任务，无需离开会话。

适合谁： 同时管理多个仓库或 monorepo 子包的开发者。

tokrepo install f0db235b --target gemini

在 TokRepo 查看 →

4. Get Shit Done (GSD)

做什么： 完整的项目管理框架。把大项目拆成里程碑、阶段和任务，逐步执行并验证。创建持久化的 .planning/ 目录，跨会话保持上下文。

适合谁： 独立开发者管理复杂的多日项目，不想丢失上下文。

tokrepo install e108cf5c --target gemini

为什么必装： 解决 AI 编程最大的痛点——大项目上下文丢失。GitHub 48,600+ stars，三大 CLI 工具通用。

在 TokRepo 查看 →

5. Vercel Skills — Agent Skill 生态

做什么： 13,000+ 社区贡献的 Skill，覆盖 Next.js、React、部署流水线和全栈开发模式。

适合谁： 使用现代 JavaScript 框架的前端和全栈开发者。

tokrepo install d1eba6f1 --target gemini

在 TokRepo 查看 →

6. Claude SEO — 完整 SEO 技能

做什么： 全面的 SEO 审计——关键词研究、页面分析、内容缺口、技术检查、竞品对比。虽然名字带 Claude，但 Markdown 指令在任何读取结构化提示的 CLI 中都能用。

适合谁： 想在终端做 SEO 分析的开发者和运营人员。

tokrepo install cb068086 --target gemini

在 TokRepo 查看 →

7. Systematic Debugging — 系统化调试

做什么： 结构化调试方法论，带持久状态追踪。引导模型完成假设建立、证据收集、根因隔离和修复验证。

适合谁： 难以复现的 Bug，需要跨多文件的系统化排查。

tokrepo install 78ed006e --target gemini

在 TokRepo 查看 →

8. Web Access — 网页访问

做什么： 让 Gemini CLI 能抓取和分析网页、API 和在线文档。读取 URL、提取内容并用于当前任务。

适合谁： 需要检查文档、对比 API 或分析竞品页面的调研任务。

tokrepo install 5766b7f4 --target gemini

在 TokRepo 查看 →

Gemini CLI vs Claude Code vs Codex CLI

三大 AI 编程 CLI 工具横向对比：

要点总结：

• Gemini CLI 胜在免费额度（Google 账号即可获得 60 次/分钟）和 Google Cloud 集成。GEMINI.md 格式入门最简单。
• Claude Code 拥有最成熟的 Skill 生态（TokRepo）和最强的复杂重构推理能力。
• Codex CLI 与 OpenAI 模型家族深度集成，AGENTS.md 格式简洁直观。详见 Codex CLI Skills 指南。

三者都支持 Markdown 格式的 Skill，TokRepo 上的大多数 Skill 只需微调格式就能跨平台使用。

常见问题

同一个 Skill 能在 Gemini CLI、Claude Code 和 Codex CLI 之间通用吗？

可以。Skill 的核心是 Markdown 指令——编码规范、测试规则、部署步骤——这些和模型无关。唯一的区别是文件位置（GEMINI.md vs .claude/commands/ vs AGENTS.md）和触发语法。TokRepo 的 --target 参数会自动处理转换。更多兼容性细节见 Skills vs MCP vs Rules 完整对比。

Gemini CLI 真的免费吗？

CLI 本身免费开源（Apache 2.0）。用 Google 账号登录后，每分钟可免费调用 60 次。如果需要更高频率或企业级使用，需要申请 Gemini API Key，按量计费。

怎么为 Gemini CLI 创建自定义 Skill？

写一个 Markdown 文件，保存为项目根目录的 GEMINI.md，或放到 ~/.gemini/ 下全局生效。具体步骤参考教程：如何创建你的第一个 Agent Skill。流程和其他 AI CLI 完全一样——写完还可以发布到 TokRepo 让其他人安装使用。

下一步

• 如何创建你的第一个 Agent Skill — 为 Gemini CLI 或任何 AI 编程助手构建自定义技能
• Skills vs MCP vs Rules 完整对比 — 搞清楚什么时候用 Skill、MCP 还是配置规则
• Codex CLI Agent Skills 指南 — OpenAI CLI 工具的同类指南
• 浏览 500+ Skill — 找到适合你技术栈的 Skill