Agent Skills

Agent Skills 让你用专业知识、流程化的工作流和特定任务的资源扩展 Gemini CLI。它基于 Agent Skills 开放标准：一个「skill」是把指令和资源打包成可发现能力的自包含目录。与提供持久的、覆盖整个工作区的背景的通用上下文文件（GEMINI.md）不同，skills 代表按需的专业能力，让 Gemini CLI 能维持庞大的专门能力库（如安全审计、云部署或代码库迁移）而不挤占模型当前的上下文窗口。

工作原理

1. 发现：会话开始时，Gemini CLI 扫描各个发现层级，把所有启用的 skills 的名字和描述注入系统提示
2. 激活：Gemini 识别出与某个 skill 描述匹配的任务时，调用 activate_skill 工具
3. 同意：你会在界面里看到确认提示，说明 skill 的名称、用途以及它将获得访问权限的目录路径
4. 注入：你批准后，SKILL.md 正文和文件夹结构被加入对话历史，skill 的目录被加入智能体允许访问的文件路径，授予它读取任何捆绑资源的权限
5. 执行：模型带着专业能力继续，并被指示在合理范围内优先遵循该 skill 的流程指导

发现层级

Gemini CLI 从几个位置发现 skills，按特定的优先顺序（从低到高）：

1. 内置 skills：Gemini CLI 自带的、提供基础能力的标准 skills
2. 扩展 skills：已安装扩展里捆绑的 skills
3. 用户 skills：位于 ~/.gemini/skills/ 或其别名 ~/.agents/skills/
4. 工作区 skills：位于 .gemini/skills/ 或别名 .agents/skills/，通过版本控制与团队共享

多个 skill 同名时，使用更高优先级位置的版本；在同一层级（用户或工作区）内，.agents/skills/ 别名优先于 .gemini/skills/ 目录。.agents/skills/ 别名提供一个可互操作的路径，用来管理在不同 AI 工具间兼容的、特定智能体的专业能力。

主要好处

• 共享专业知识：把复杂工作流（如某团队的 PR 评审流程）打包成任何人都能用的文件夹
• 可重复的工作流：通过提供流程框架，确保复杂的多步骤任务被一致地执行
• 资源捆绑：在指令旁边包含脚本、模板或示例数据，让智能体拥有所需的一切
• 渐进式披露：一开始只加载 skill 元数据（名称和描述），只有模型明确激活该 skill 时才披露详细指令和资源，节省上下文 token

管理 skills

在交互会话里，用 /skills 斜杠命令：/skills list [all] [nodesc]（显示发现的 skills；all 包含内置 skills，nodesc 隐藏描述）、/skills link <path> [--scope user|workspace]（链接本地目录里的 skills）、/skills disable <name>（阻止使用某个 skill）、/skills enable <name>（重新启用）、/skills reload（或 /skills refresh，从所有层级刷新发现的 skills 列表）。/skills disable 和 /skills enable 默认作用于 user 范围，要管理工作区特定的设置用 --scope workspace。

在终端里，用 gemini skills 命令：

# 列出所有发现的 skills，用 --all 包含内置 skills
gemini skills list --all

# 从 Git 仓库或本地目录安装 skill，用 --consent 跳过安全确认提示
gemini skills install https://github.com/user/repo.git --consent

# 卸载 skill
gemini skills uninstall my-skill --scope workspace

命令选项：--scope（user（全局，默认）或 workspace（项目本地））、--path（Git 仓库里包含该 skill 的子目录）、--consent（承认安全风险并跳过安装时的交互式确认）。创建 skill 的步骤和最佳实践见官方「Creating Agent Skills」和「Best practices」页。