# Skills 安装、链接与管理

> 使用会话命令和终端工具，区分安装同意、激活同意和工作区范围。

- 网址：https://funcoding.ai/agents/gemini-cli/build/skills-management/
- 核实日期：2026-10-08（命令、配置和价格以官方文档为准）
- 官方来源：[Gemini CLI 官方文档：Agent Skills](https://geminicli.com/docs/cli/skills)、[Gemini CLI 官方文档：Managing Agent Skills](https://geminicli.com/docs/cli/using-agent-skills)、[Gemini CLI 官方文档：CLI cheatsheet](https://geminicli.com/docs/cli/cli-reference)

---
开发中的 Skill 用 link 便于反复修改，固定版本的外部 Skill 用 install 管理。安装成功后仍需确认是否被当前会话发现、启用及激活。

## 会话命令

| 命令 | 用途 |
| --- | --- |
| `/skills list` | 查看已发现 Skill |
| `/skills list all` | 包含内置 Skill |
| `/skills list nodesc` | 隐藏描述 |
| `/skills reload` | 从磁盘重新发现 |
| `/skills refresh` | reload 别名 |
| `/skills link <path>` | 链接本地 Skill |
| `/skills disable <name>` | 禁用指定 Skill |
| `/skills enable <name>` | 重新启用 |

enable/disable 默认 user 作用域；项目设置使用 `--scope workspace`。不要在项目目录运行命令后就假定它必然只影响该项目。

## 终端命令

```bash
gemini skills list --all
gemini skills install https://github.com/user/my-awesome-skill
gemini skills link ./path/to/my-skill
gemini skills uninstall my-skill --scope workspace
```

仓库与路径是占位示例，需替换。安装支持 Git、目录或本地 Skill 包，默认装到 user；`--scope workspace` 选择当前项目，`--path` 指定 Git 仓库内子目录。

终端还支持 gemini skills enable/disable，以及各自的 --all；使用前检查范围和当前列表。

## 安装与激活是两次判断

远程安装会要求确认来源；`--consent` 表示接受风险并跳过安装交互，不应理解为后续任意脚本都已经获准执行。激活时还会加载 Skill 内容并提供资源访问，普通 Skill 会有相应确认。

## 本地开发

link 建立本地引用，修改后用 reload 刷新发现。若同名 Skill 位于更高层，当前编辑的版本可能被覆盖；先确认实际路径，再排查描述为何没有触发。

## 分发

团队可在仓库保留工作区 Skill，也可通过扩展或独立 Git 仓库分发。共享前审阅 SKILL.md 与捆绑脚本，避免把本机凭据和调试数据随资源一同发布。