# 安装与使用技能

从技能库、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`。导入多层目录时系统会寻找靠近根部的技能入口，导入前应确认目录对应所需技能。

## 把仓库地址拆成导入字段

一个仓库可以包含多个技能。假设技能位于仓库的 `skills/report-review/SKILL.md`，Git 导入需要指定技能目录。

| 字段 | 示例 | 说明 |
| --- | --- | --- |
| 仓库地址 | `https://github.com/your-team/work-skills.git` | 换成真实仓库，不填文件浏览页链接 |
| 分支 | `main` | 仓库默认分支不同时填写实际分支 |
| 子目录 | `skills/report-review` | 指向含 SKILL.md 的目录，不填文件名 |

示例仓库仅说明填写方式。先检查目录里有没有所需脚本和资料，再导入。只取得 `SKILL.md` 而漏掉它引用的文件，可能导致安装成功但任务执行失败。

## ZIP 内容怎样组织

```text
report-review/
  SKILL.md
  references/
    checklist.md
  scripts/
    check-report.py
```

`SKILL.md` 是入口，其他目录按该技能的实际需要提供，不必为简单技能建空目录。ZIP 中的相对引用应能在解压后找到对应文件。外层套有仓库目录时，确认最终导入的是目标技能，不能只凭压缩包名字判断。

## 安装、启用和本次使用分别检查

| 操作 | 影响范围 | 如何确认 |
| --- | --- | --- |
| 导入技能 | 将技能加入全局资源库 | 能打开详情并读到预期内容 |
| 在 Agent 中启用 | 该成员长期可用的技能 | 联系人详情中检查启用状态 |
| 在 Room 中启用 | 房间可用的协作技能 | 检查 scope 与 Room 设置 |
| 使用 `/skills` | 当前请求的技能选择 | 发送前查看输入框带入的技能 |

名称相似的技能可能来自不同来源。试用前打开详情检查内容，再在请求中明确指定技能和交付物。不要通过安装多个同名条目尝试修复启用问题。

## 使用和验证

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

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

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

## 如何判断技能确实起作用

用一份有已知问题的教学草稿测试，例如故意缺少日期或来源。技能要求先检查事实时，输出应指出这些缺口；要求保存复核文件时，应能打开对应文件。

任务未按方法执行时，依次检查入口内容、适用条件、启用范围和依赖。技能需要连接器或脚本运行环境时，分别验证这些依赖。修改权限模式不会安装缺少的程序。

## 更新与移除

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

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

## 更新后的回归检查

更新前保留当前技能来源、分支和关键要求，阅读新增脚本或外部访问。更新后用同一份教学材料再跑一次，比较检查结果和交付格式，避免把方法变化误认作模型随机变化。

固定工作流程需要稳定版本时，应由技能维护者管理仓库版本，不把“已检查更新”当成内容永远不变的保证。需要自己编写完整入口，阅读[Agent Skill 编写](/docs/skill-authoring)。

## 自己编写

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