# 安装与使用技能

从技能库、Git 或 ZIP 导入工作方法，再为 Agent 或 Room 启用。

## Skill 提供工作方法

Skill 描述什么时候使用、按什么步骤执行，以及怎样检查交付。它可以附带脚本、模板和资料。安装一个 Skill 不代表已经给它需要的外部服务授权。

## 从技能库开始

进入 **能力 → 技能**，搜索名称、标签或分类，打开详情查看说明。优先确认适用任务、来源、依赖和可能执行的脚本。

技能库管理全局资源，Agent 是否使用某项技能由各自的启用状态决定。`scope: room` 的技能在 Room 设置中启用。

## 导入 Git 或 ZIP

![桌面版技能导入窗口中的 ZIP 与 Git 两种入口](/images/docs/skill-import.png)

*桌面版实图，导入前先确认技能来源与内容。*

1. 打开 **导入 Skill**。
2. 使用 Git 方式时填写 HTTPS 仓库地址；可选分支，技能不在根目录时填写子目录，例如 `skills/report-review`。
3. 使用 ZIP 方式时选择包含 `SKILL.md` 的压缩包。
4. 完成导入后重新打开详情，检查名称、说明和来源。
5. 在目标 Agent 或 Room 中启用，再发一个适合它的小任务。

技能压缩包必须包含 `SKILL.md`。导入多层目录时系统会寻找靠近根部的技能入口，导入前应确认目录对应所需技能。

## 使用和验证

```text
请使用已启用的报告复核技能检查这份草稿。
先列出事实缺口，再检查结构；交付 review.md，不直接发布。
```

检查 Agent 是否遵循技能中的步骤，以及相关工具是否能运行。未调用时核对适用条件、启用范围和当前上下文，并确认该技能适用于所选运行引擎。

在输入框输入 `/skills` 可以为当前请求临时选择技能，不改变 Agent 的长期启用设置。系统必需的技能可能显示为锁定，不能像普通技能一样关闭。

## 更新与移除

使用技能页的更新检查查看外部导入技能的新版本。更新前阅读来源变化，尤其是脚本和外部访问。保存或更新完成但目录未刷新时，先刷新当前状态，避免重复导入。

不再需要时先从使用它的 Agent 或 Room 停用，再根据需要移除全局条目。移除技能不会撤销它此前已经写入的文件或外部结果。

## 自己编写

一套方法经过任务验证后，就可以整理成[Agent Skill](/docs/skill-authoring)。多人协作的交接、汇总和停止规则使用[Room Skill](/docs/room-skills)。