跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

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

什么是技能?

你可以把技能看作是你提供给 Agent 的专家知识。一个技能可以教会它如何:
  • 按照你团队的标准审查代码
  • 生成特定类型的组件
  • 执行部署工作流程
  • 执行安全审计
  • 基于模板搭建新服务

斜杠命令调用

用户可以在聊天中使用 /skill-name 调用技能。

Agent 自主性

Agent 可以在适当时机自行调用技能。

作用域权限

技能可以有自己的权限授予和限制。

自定义工具访问

为确保安全,可以限制某个技能可使用的工具。

子 Agent 执行

将技能作为独立的 子 Agent 运行,并拥有各自的上下文窗口。

模型覆盖

为特定技能使用不同的 模型

快速示例

.devin/skills/review/SKILL.md (或 .windsurf/skills/review/SKILL.md) 中创建一个代码评审技能:
---
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. 会应用该技能配置中的额外权限
  4. 将使用指定的模型 (如果与当前模型不同)
技能执行完成后,会话将恢复为常规配置。

技能触发方式

技能可通过两种方式调用:
触发方式描述默认
user用户可使用 /skill-name 调用已启用
modelAgent 可在相关情况下自主调用已启用
---
name: security-check
triggers:
  - user
  - model
---
triggers: [user] 设置为防止 Agent 自行调用技能。

第三方技能

我们支持 .agents 技能标准,因此第三方技能安装工具可与 Devin CLI 搭配使用。
第三方技能可执行任意代码,因此安装它们的风险需由你自行承担。

技能存放位置

技能既可以限定在单个项目中,也可以在所有项目间共享:
位置作用域提交到 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 规范) 或 ~/.codeium/<channel>/skills/ (其中 <channel> 会根据你的 CLI 渠道而有所不同,可能是 windsurfwindsurf-nextwindsurf-insiders) ,并且可在你机器上的所有项目中使用。
Windows: 全局技能路径遵循你系统的应用程序数据目录。在 Windows 上,请使用 %APPDATA%\devin\skills\<name>\SKILL.md (通常为 C:\Users\<YourUser>\AppData\Roaming\devin\skills\<name>\SKILL.md) ,而不是 ~/.config/devin/skills/

后续步骤

创建 技能

了解完整的 技能 格式,包括 frontmatter 选项、动态内容和示例。