Skip to main content
不想手动设置?将此页面的链接粘贴到 Devin 会话中,让它为你完成所有设置。
1

编写文档技能

首先,为您希望标准化的任务创建一个技能。在本示例中,我们将构建一个技能,每当团队成员为工单添加标签时,就自动生成 API 文档。前往 Customize > Skills,点击 + (New skill) ,并将其命名为 add-docs。编写具体的分步说明,并引用真实的文件路径和规范,以便 Devin 遵循您团队的标准:技能写得越具体,输出效果就越好。请引用您团队实际使用的文档模板、风格指南和工具。更多信息请参阅编写优质技能。
2

将技能同步到 Linear

如果你尚未连接 Linear 集成,请先完成连接:前往 设置 > 连接 > Linear,点击 Connect,然后选择 Devin 可以访问的团队。连接完成后,向下滚动到 技能 部分,点击 Add skill,然后从下拉菜单中选择 add-docs。系统会在 Linear 的 Devin Skills 标签组中创建该技能对应的标签;技能列表中会显示需要使用的标签 (如果没有其他已同步的技能与之同名,则为 @skills:add-docs) ,并提供一个复制该标签的按钮。此后,只要有人为工单添加该标签,Devin 就会使用你的技能启动一个会话。
要让技能标签自动同步到 Linear,你的 Linear workspace 必须将 Manage workspace labels 设置为 All members (位于 Linear 的 Settings > Security 下) 。如果未启用该设置,你需要在 Linear 中手动创建这些标签。
3

为工单添加标签并生成文档

当团队成员为如下工单添加 @skills:add-docs 标签时:
ENG-215: Add POST /api/v2/webhooks endpoint — accepts a URL and event types, validates the URL is reachable, stores the subscription, and returns the webhook ID.
Devin 会自动启动会话,并按照您的文档技能执行以下步骤:
  • 读取工单 — 获取端点描述、参数以及所有已关联的 PR
  • 查找源代码 — 定位 route 处理程序、请求验证 schema 和响应类型
  • 生成文档 — 按照您现有的格式在 docs/api/ 中创建新页面
  • 创建 PR — 包含新的文档页面和更新后的 sidebar
此方法同样适用于批量操作:使用 Cmd+A 多选工单,右键点击,然后添加 @skills:add-docs 标签,即可为多个端点并行生成文档。
安装 Linear 集成后,Devin 可直接使用 Linear 的工具,因此您可以在技能中指示 Devin 根据结果更新工单标签或状态。由于标签可以触发其他自动化,您可以将多个工作流程串联起来。例如,文档生成后,可通过 Docs Ready 标签通知技术文档工程师进行审查。
4

为您的团队构建更多技能

同样的模式适用于任何周期性任务。创建一个技能并将其同步为标签,您的团队就可以从任意工单触发它。以下是一些示例:
  • @skills:write-tests — 为工单中描述的功能补充测试,提高测试覆盖率
  • @skills:refactor — 按照团队的规范重构代码
  • @skills:security-audit — 审查代码中的安全漏洞,并提交包含修复的 PR
  • @skills:migrate — 运行标准化迁移 (依赖升级、API 版本升级)
您还可以设置自动化,让 Devin 无需任何人添加标签即可自动开始工作。前往 设置 > 连接 > Linear,滚动到 Automations,点击 Add automation,然后配置一个在工单切换到特定状态或被添加特定标签时触发的自动化。