> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 技能概览

> 技能是面向 Devin CLI 的可复用 SKILL.md 提示与工作流程，可通过斜杠命令或由 Agent 调用，并拥有各自的权限。

技能是可传授给 Devin CLI 的独立功能单元。它们将提示、工具访问、权限和工作流程整合为可复用的套件，可由 Agent 或人工操作员调用。

***

## 什么是技能？

你可以把技能看作是你提供给 Agent 的专家知识。一个技能可以教会它如何：

* 按照你团队的标准审查代码
* 生成特定类型的组件
* 执行部署工作流程
* 执行安全审计
* 基于模板搭建新服务

> [card] 斜杠命令调用
>
> 用户可以在聊天中使用 `/skill-name` 调用技能。

> [card] Agent 自主性
>
> Agent 可以在适当时机自行调用技能。

> [card] 作用域权限
>
> 技能可以有自己的权限授予和限制。

> [card] 自动批准的工具
>
> 预先批准某个技能所需的工具，使其运行时无需权限提示。

> [card] 子 Agent 执行
>
> 将技能作为独立的 [子 Agent](https://docs.devin.ai/zh/cli/subagents.md) 运行，并拥有各自的上下文窗口。

> [card] 模型覆盖
>
> 为特定技能使用不同的 [模型](https://docs.devin.ai/zh/cli/models.md)。

***

## 快速示例

在 `.devin/skills/review/SKILL.md` (或 `.windsurf/skills/review/SKILL.md`) 中创建一个代码评审技能：

```markdown theme={null}
---
name: review
description: 在提交前审查代码修改
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

审查当前的 git diff 并提供反馈：

1. 运行 `git diff --staged`（如果没有暂存内容，则运行 `git diff`）
2. 检查以下内容：
   - 逻辑错误或 bug
   - 缺少错误处理
   - 安全问题
   - 风格不一致
3. 总结发现的问题并提出改进建议
```

现在你可以在任何会话中通过 `/review` 调用它。

***

## 技能的工作方式

调用技能时：

1. 技能的提示会被注入到对话中
2. 技能的 `allowed-tools` 中列出的工具 (如已指定) 会自动获批，因此运行时不会弹出权限提示。未列出的工具依然可用，但需经过正常的权限检查
3. 技能的 `permissions` (`allow`、`deny`、`ask`) 会生效。可使用 `permissions.deny` 在技能运行期间禁用某个工具
4. 使用指定的模型 (如果与当前模型不同)

> [!NOTE]
>
> `allowed-tools` 和 `permissions` 仅适用于以 inline 方式运行的技能。以 [子 Agent](https://docs.devin.ai/zh/cli/extensibility/skills/creating-skills.md#running-skills-as-subagents) 方式运行的技能 (`subagent: true` 或 `agent:`) ，其工具访问权限来自子 Agent profile。

***

## 技能触发方式

技能可通过两种方式调用：

| 触发方式 | 描述 | 默认 |
| - | - | - |
| `user` | 用户可使用 `/skill-name` 调用 | 已启用 |
| `model` | Agent 可在相关情况下自主调用 | 已启用 |

```yaml theme={null}
---
name: security-check
triggers:
  - user
  - model
---
```

将 `triggers: [user]` 设置为防止 Agent 自行调用技能。

***

## 第三方技能

我们支持 `.agents` 技能标准，因此第三方技能安装工具可与 Devin CLI 搭配使用。

> [!WARNING]
>
> 第三方技能可执行任意代码，因此安装它们的风险需由你自行承担。

***

## 技能存放位置

技能既可以限定在单个项目中，也可以在所有项目间共享：

| 位置 | 作用域 | 提交到 git？ |
| - | - | - |
| `.agents/skills/<name>/SKILL.md` | 项目级 | 是 |
| `.devin/skills/<name>/SKILL.md` | 项目级 | 是 |
| `.windsurf/skills/<name>/SKILL.md` | 项目级 | 是 |
| `~/.agents/skills/<name>/SKILL.md` | 全局 (所有项目) | 否 |
| `~/.config/devin/skills/<name>/SKILL.md` | 全局 (所有项目) | 否 |
| `~/.codeium/<channel>/skills/<name>/SKILL.md` | 全局 (所有项目，取决于 channel) | 否 |

**项目技能**位于项目根目录下的 `.devin/skills/` 或 `.windsurf/skills/` 目录中，并会提交到版本控制中，因此可与你的团队共享。这两个位置都使用相同的 `SKILL.md` 格式。

**全局技能**位于 `~/.config/devin/skills/` (遵循 [XDG 规范](https://specifications.freedesktop.org/basedir-spec/latest/)) 或 `~/.codeium/<channel>/skills/` (其中 `<channel>` 会根据你的 CLI 渠道而有所不同，可能是 `windsurf`、`windsurf-next` 或 `windsurf-insiders`) ，并且可在你机器上的所有项目中使用。

> [!NOTE]
>
> **Windows：** 全局技能路径遵循你系统的应用程序数据目录。在 Windows 上，请使用 `%APPDATA%\devin\skills\<name>\SKILL.md` (通常为 `C:\Users\<YourUser>\AppData\Roaming\devin\skills\<name>\SKILL.md`) ，而不是 `~/.config/devin/skills/`。

***

## 后续步骤

> [card] [创建 技能](https://docs.devin.ai/zh/cli/extensibility/skills/creating-skills.md)
>
> 了解完整的 技能 格式，包括 frontmatter 选项、动态内容和示例。

> [card] [插件](https://docs.devin.ai/zh/cli/extensibility/plugins/overview.md)
>
> 将 技能 打包为可安装并可跨项目共享的插件。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.