跳转到主要内容

​
什么是 Skills？

Skills 是你提交到代码仓库中的 SKILL.md 文件，用来教 Devin 如何对你的应用进行端到端测试——如何启动服务、本地运行应用、在浏览器中验证变更，以及在打开 PR（pull request，合并请求）之前确认一切正常工作。它们遵循开放的 Agent Skills 标准，因此同一套 Skill 文件可以在多个 AI 编码工具之间通用。 请在代码仓库中将 Skill 文件放在 .agents/skills/<skill-name>/SKILL.md 路径下。Devin 会自动在所有已连接的代码仓库中发现这些文件。完整的文件格式参考请参见 Agent Skills 规范。

​
为什么 Skills 很重要

如果没有 Skills，Devin 每次会话都必须从头开始弄清楚如何运行和测试你的应用。有了 Skills，Devin 就清楚地知道该如何：
  • 启动本地开发环境 — 要运行哪些服务、使用哪些端口、如何准备/填充测试数据
  • 在浏览器中验证改动 — 要检查哪些页面、什么样才算“正确”、哪些异常需要标记出来
  • 运行合适的测试套件 — 要执行哪些命令、通过时的输出应该是什么样

​
Devin 会自动推荐技能

Devin 可以为你自动推荐技能。在一次会话过程中，当 Devin 测试完你的应用，或是对你的环境有了新的了解之后，它会建议创建或更新一个 skill，以将这些 Knowledge 固化下来。你会在会话时间轴中看到一个建议，其中包括：
  • 学到内容的摘要（例如 “how to start the backend with Docker” 或 “如何使用 Docker 启动后端”）
  • 建议的 SKILL.md 文件内容
  • 一个用于将该 skill 提交到代码仓库的 “Create PR” 按钮
随着时间推移，Devin 会在你的代码仓库中逐步构建起一套关于如何运行和测试你的应用的技能库。

​
快速示例

一个用于指示 Devin 如何测试 Next.js 应用的技能： 
---
name: test-before-pr
description: Run the local dev server and verify pages before opening any PR that touches frontend code.
---

## Setup

1. Install dependencies: `npm install`
2. Start the database: `docker-compose up -d postgres`
3. Run migrations: `npx prisma migrate dev`
4. Start the dev server: `npm run dev`
5. Wait for "Ready on http://localhost:3000"

## Verify

1. Read the git diff to identify which pages changed
2. Open each affected page in the browser
3. Check for: console errors, layout issues, broken links
4. Screenshot each page at desktop (1280px) and mobile (375px) widths

## Before Opening the PR

1. Run `npm run lint` and fix any issues
2. Run `npm test` and confirm all tests pass
3. Include screenshots in the PR description

​
技能发现

Devin 会从两个来源中发现技能，并在每次会话开始时将它们合并：
  1. 已建立索引的代码库（indexed repos） — Devin 的后端会在与你的组织连接的所有代码库中为 SKILL.md 文件建立索引。这些技能在会话开始时即可立即使用，此时还未克隆任何代码库。
  2. 已克隆的代码库（cloned repos） — 当代码库被克隆到会话使用的机器上时，Devin 会在磁盘上扫描其中的 SKILL.md 文件。通过磁盘扫描发现的技能会更新或覆盖来自同一代码库的任何匹配的索引技能，确保 Devin 始终使用当前正在处理分支上的最新版本。
当某个代码库在会话中途完成克隆时，Devin 会自动重新扫描该代码库，从而在无需重启的情况下识别到新添加或已修改的技能。

​
支持的技能文件位置

Devin 会在以下所有目录中搜索 SKILL.md 文件：
  • .agents/skills/<skill-name>/SKILL.md （推荐）
  • .github/skills/<skill-name>/SKILL.md
  • .claude/skills/<skill-name>/SKILL.md
  • .cursor/skills/<skill-name>/SKILL.md
  • .codex/skills/<skill-name>/SKILL.md
  • .cognition/skills/<skill-name>/SKILL.md
在每个代码仓库中都会扫描上述六个路径。

​
Devin 从技能文件中加载的内容

当发现某个技能时，Devin 会解析 YAML frontmatter（顶部的 --- 块）并提取：
FieldPurpose
name标识该技能。如果省略，则回退到父目录名称。
description在技能列表中显示的简短摘要，让 Devin（以及你）知道该技能的作用。
allowed-tools限制技能处于激活状态时 Devin 可以使用哪些工具。
除了标准规范外，Devin 还支持以下额外的 frontmatter 字段：
FieldPurpose
argument-hint与技能名称一起显示的提示文本，用于描述预期的参数。
triggers控制谁可以调用该技能——默认是 ["user", "model"]。将其设置为 ["user"] 可以阻止 Devin 自动激活该技能。
frontmatter 之后的所有内容都是技能主体——当技能被调用时，Devin 会按照其中的分步指令执行。 完整的文件格式参考请参见 Agent Skills specification。 除了标准规范外，Devin 还在技能主体中支持两种在调用时处理的动态内容：
  • $ARGUMENTS —— 替换为调用技能时传入的完整参数字符串（例如通过 @skills:deploy staging prod）。你也可以按索引访问单个参数：第一个参数用 $ARGUMENTS[0] 或 $0，第二个参数用 $ARGUMENTS[1] 或 $1，依此类推。参数按空白字符拆分。
  • !`command` —— 在仓库根目录执行该命令，并用其标准输出替换，从而让技能可以包含分支名、端口号等动态值。
例如，一个部署技能可能会像这样使用参数： 
---
name: deploy
description: Deploy the app to a target environment.
argument-hint: <environment>
---

1. Check out the `$ARGUMENTS` branch
2. Run `./scripts/deploy.sh $0`
3. Verify the deployment at `https://$0.example.com`
调用 @skills:deploy staging 时，会用 staging 替代 $ARGUMENTS 和 $0。

​
Devin 如何使用技能

在每次会话开始时，Devin 会看到所有可用技能的列表（名称 + 描述）。当某个技能被调用时，Devin 会读取完整的 SKILL.md 文件，并将其正文作为系统级指令注入到当前上下文中。这意味着在接下来的任务中，Devin 会主动遵循该技能中的步骤——它不仅仅是一个参考，而是直接引导 Devin 的行为。 Devin 可以通过多种方式使用技能：

​
自动调用

当 Devin 判断某个技能与当前任务相关时，会自动调用它。比如，如果你让 Devin 修复前端代码中的一个 bug，并且存在一个 test-before-pr 技能，Devin 会在打开 PR 之前先激活它。若要禁止对只希望显式触发的技能进行自动调用，请在 frontmatter 中设置 triggers: ["user"]。

​
在提示中提到某个技能

你可以在消息中加入 @skills:skill-name 来让 Devin 使用某个特定技能： 
Fix the login bug on the /auth page @skills:test-before-pr
你还可以传入参数： 
@skills:deploy staging
在技能主体中，凡是出现 $ARGUMENTS、$ARGUMENTS[0]、$1 等的地方，都会被替换为对应的参数值。

​
一次只启用一个技能

Devin 在同一时间只能有一个技能处于激活状态。调用一个新技能会替换掉之前的技能。技能被激活时，Devin 会按照该技能的步骤依次执行，完成每一步后再继续进行下一步。

​
搜索和列出

如果 Devin 需要在会话中途找到合适的技能，它可以按关键词或目录搜索技能。你也可以让 Devin 列出可用技能，或在你向技能文件推送更改后重新加载这些技能。

​
限制

  • 全局 / 组织级技能 — 目前，技能只存在于各个代码仓库中。对于组织范围的技能，可以创建一个专门的「skills」仓库作为变通方案。我们正在探索对适用于所有仓库的组织级技能提供原生支持。
  • 组合多个技能 — 当前一次只能激活一个技能。我们正在开发对工作流串联与组合的支持。

​
了解更多

  • Agent Skills 规范 — 针对 SKILL.md 文件格式、frontmatter 前置字段和目录结构的开放标准
  • Knowledge — 用于提供上下文提示和事实信息（而非分步操作指南）
  • Playbooks — 用于附加到会话的可重用提示模板