← Guias · English · 日本語 · 中文

Atualizado 2026-11-19

Nesta página
  1. Por que skills são a camada que importa agora
  2. Passo 1 — Onde os skills ficam
  3. Passo 2 — O contrato do SKILL.md
  4. Passo 3 — Três caminhos de invocação
  5. Passo 4 — Crescendo a biblioteca
  6. Passo a passo real — uma skill de repositório invocada de verdade, no Devin CLI v3000.14 (swe-2-flash-medium)
  7. Checklist de verificação
  8. Armadilhas
  9. Teste de conhecimento
  10. Fontes

Guia 17 — Skills e plugins: a camada de empacotamento pós-playbook

Objetivo: codificar os procedimentos repetíveis da sua org como SKILL.md para que toda sessão e Bot os siga — e empacotar/compartilhar entre repositórios com plugins. Nível: intermediário · a camada que substituiu os playbooks Fontes: docs.devin.ai/product-guides/skills · release notes · complementa o Guia 9

Por que skills são a camada que importa agora

Os Playbooks estão migrando para Skills: as contas migram uma a uma e contas novas (a partir de 24-out-2026) só têm Skills — cada playbook vira um skill com o mesmo escopo org/enterprise. Skills também seguem o padrão aberto Agent Skills, então os mesmos arquivos funcionam em outros agentes de código. Tudo que você sabia sobre escrever playbooks continua valendo; o que mudou é o formato do arquivo e o modelo de descoberta.

Artefato Onde vive Melhor uso
Knowledge Página Customize / notas do repo Contexto permanente — fatos que Devin não consegue saber
Bot instructions O Bot Regra do cargo para um "funcionário"
Skill SKILL.md no repo, ou num plugin Um procedimento nomeado e invocável
Rule Plugin Restrição permanente ("never force-push")
Hook Plugin Execução determinística em torno de chamadas de ferramenta

Passo 1 — Onde os skills ficam

Duas fontes de descoberta, ambas automáticas:

  1. Repositórios — faça commit de SKILL.md; Devin varre os dez caminhos de vendor em todo repo conectado: .agents/skills/ (recomendado), .devin/skills/, .github/skills/, .claude/skills/, .cognition/skills/, .windsurf/skills/, .cursor/skills/, .codex/skills/, .codeium/skills/, .kiro/skills/. Skills de repo seguem a versão da branch — um clone no meio da sessão é varrido ao terminar.
  2. Plugins — um plugin empacota skills + rules + MCP servers + hooks, instalado no escopo personal, organization ou enterprise; seus skills entram no contexto antes de qualquer clone.

Passo 2 — O contrato do SKILL.md

---
name: test-before-pr
description: Run the dev server and verify pages before any frontend PR.
argument-hint: <environment>
triggers: ["user"]
allowed-tools: read, grep, glob
permissions:
  allow: ["Exec(npm run *)"]
---

## Setup
1. `docker-compose up -d postgres` && `npm run dev`
## Verify
1. Open each page touched by the diff
2. Screenshot at 1280px and 375px

Campos de frontmatter que mudam o comportamento:

Passo 3 — Três caminhos de invocação

Passo 4 — Crescendo a biblioteca

Passo a passo real — uma skill de repositório invocada de verdade, no Devin CLI v3000.14 (swe-2-flash-medium)

O caminho explícito do Passo 3, de ponta a ponta: uma skill coverage-check commitada em .devin/skills/coverage-check/SKILL.md num repositório demo, depois invocada numa sessão nova. A descoberta funciona como documentado — digitar / listou a skill pelo nome, com a description como texto do autocomplete.

Vídeo (60 s, sem áudio): SKILL.md → autocomplete de barra → Invoked skill coverage-check → aprovação → relatório.

O relatório da skill — tabelas de cobertura por função de app.py e orders.py

1. A skill no disco — name/description no frontmatter, depois um procedimento numerado 1. A skill no disco — .devin/skills/coverage-check/SKILL.md: name/description no frontmatter + procedimento numerado

2. Digitar / lista a skill — nome + description são a entrada do autocomplete 2. Digitar / lista a skill — a descoberta carrega exatamente nome + description

3. Invoked skill coverage-check — até o primeiro comando espera um Allow 3. Invoked skill coverage-check — o primeiro comando já precisa de Allow

4. O procedimento roda literalmente — unittest, depois lê cada arquivo-fonte e de teste 4. O procedimento roda literalmente — python3 -m unittest -v, depois lê app.py, orders.py e os dois arquivos de teste

5. Resultado: cobertura total — tabelas por função citando cada branch; nenhum arquivo modificado, sem commits 5. Resultado: cobertura total — cada branch contabilizada, exatamente o relatório que a SKILL.md pediu

Checklist de verificação

Armadilhas

Teste de conhecimento

  1. Por que a description importa mais que o corpo do skill? (É o único texto carregado no início da sessão — dirige a auto-invocação; o corpo só carrega depois que o skill é escolhido.)
  2. Quando um procedimento deve ser um plugin skill e não um repo skill? (Quando todo repo/sessão do escopo precisa dele — plugins carregam antes do clone e não derivam por branch.)
  3. Como tornar seguro um skill com passos destrutivos? (triggers:["user"] para invocação só explícita, mais permissions.ask nos matchers das ferramentas perigosas.)

Fontes