← Guias · English · 日本語 · 中文

Atualizado 2026-11-19

Nesta página
  1. A única regra por trás de tudo
  2. O catálogo de receitas
  3. Incidentes & saúde de produção
  4. Higiene agendada (a página de maior ROI dos docs)
  5. Qualidade de código
  6. Migrações & feature work
  7. Gestão de projeto & dados
  8. Ficando melhor no próprio Devin ("Devin Optimization")
  9. Como usar este cookbook
  10. Passo a passo real — uma receita executada de verdade, no Devin CLI v3000.14 (swe-2-flash-medium)
  11. Checklist de verificação
  12. Armadilhas
  13. Teste de conhecimento
  14. Fontes

Guia 13 — O cookbook oficial de casos de uso

Objetivo: os padrões de uso comprovados dos próprios docs da Cognition, organizados como um cookbook — o que fatiar para o Devin, e mais de 40 receitas documentadas com prompts para copiar. Nível: comece aqui para amplitude Fontes: Best Practices · Use-case gallery · use-case tutorials

A única regra por trás de tudo

Orientação oficial, lógica literal: escolha trabalho wide & shallow — um backlog grande de tarefas simples e horizontalmente escaláveis vence builds complexos do zero, sempre.

Tarefa ideal Anti-tarefa
Subtarefas repetitivas em complexidade de engenheiro júnior Features complexas net-new
< 90 minutos de trabalho manual por fatia Qualquer coisa que não se divide
Verificação passa/falha objetiva "Parece certo para mim"
Isolada, retrocompatível, paralelizável Dependências emaranhadas

Quatro ótimas formas de fatia dos docs: migrações, refactors, modernizações, backlogs de tech debt.

O catálogo de receitas

Tudo abaixo é um caso de uso documentado na galeria oficial — cada um vem com um prompt pronto para copiar. Organizado pelo trabalho que tira da semana de um humano.

Incidentes & saúde de produção

Receita Mecanismo
Auto-investigar alertas Datadog/PagerDuty Gatilho webhook/API → sessão investiga no incêndio
Auto-gerar postmortems PagerDuty resolve → Devin rascunha timeline, causa raiz, action items
Correções diárias de erros do Sentry Cron noturno puxa erros novos → PRs de correção de manhã
Depurar um bug report ponta a ponta Entregue o relato + logs Datadog + acesso ao DB → causa raiz

Higiene agendada (a página de maior ROI dos docs)

Receita Cadência
PRs semanais de update de dependências Semanal: pacotes desatualizados → PRs de upgrade testados
E2E noturno em staging Noturno: roda a suíte, abre tickets para falhas
Changelog semanal de PRs mergeados Sexta: changelog categorizado → Slack
Digest diário de saúde Datadog Diário: varredura de erros → digest no Slack
Auditoria diária do design system Diário: sinaliza cores hardcoded/tokens faltando em PRs mergeados
Limpeza de feature flags Uma sessão única remove flag + código morto pós-release
Digest semanal de status no Notion Semanal: resumo de PR/commit → Notion
PRs a partir de transcrições de reunião De hora em hora: poll Granola → extrai tarefas de eng → sessões filhas

Qualidade de código

Receita Mecanismo
Auto-corrigir bugs de PR antes do merge Devin revisa todo PR, empurra correções para a branch
Adicionar testes unitários a um serviço Construa um skill de escrita de testes, aplique a charge flows/refunds/webhooks
Pegar regressões visuais Skill de repo: screenshot de cada página afetada antes do PR
Checklist de migração em todo PR Skill de repo pega ops destrutivas, valida mudanças de schema
Dividir um router monolítico Router Express de 2.000 linhas → rotas de domínio com middleware compartilhado
Subir cobertura de código Devin analisa a suíte, escreve testes para cobrir as lacunas
Patchear CVEs conhecidas entre repos Skills oficiais (devin-vuln-fixes): inventário somente-leitura → gate de aprovação → patch em alvo confirmado → testes antes/depois → um PR por repo

Migrações & feature work

Receita Mecanismo
REST→GraphQL de 50 arquivos Escopo → pacotes sem conflito → paralelo (Guia 11)
Skill de upgrade React 18→19 Transforme o guia oficial de upgrade num skill em fases para seu codebase
Spec OpenAPI → implementação YAML spec → handlers Express + validação Zod + Supertest
Fluxo de checkout Stripe Spec → fluxo funcional + testes + verificação em browser
i18n num app Next.js install next-i18next, extração de strings, checagem em browser em 3 idiomas
Figma → pixel-perfect Figma MCP → componentes a partir de mockups
Dockerizar um app Django Dockerfile multi-stage + compose para Django/Postgres/Redis

Gestão de projeto & dados

Receita Mecanismo
Auto-triage de bugs via Linear Label aplicada → Devin investiga
PRDs → tickets de sprint PRD no Notion → tickets Linear escopados
Planos de implementação de backlog Multi-selecionar tickets Linear → planos com score de confiança
Consultas /dana no Slack Consultas de banco de dados em linguagem natural de qualquer canal
Dashboard custom de uso de API Devin constrói um dashboard sob medida na API v3

Ficando melhor no próprio Devin ("Devin Optimization")

Receita Lição
Cortar um prompt de feature 42→12 ACUs Autópsia de uma sessão cara: 3 causas raiz → reescrever o prompt
Corrida de 3 sessões num problema Sessões paralelas tentam estratégias de otimização concorrentes; a melhor vence
8 sessões paralelas de noite 8 módulos sem testes → PRs de unit tests de manhã
Avaliar 30 bibliotecas Uma sessão por biblioteca → comparação ranqueada com score
Transformar um hotfix em skill Extraia uma sessão de incidente bem-sucedida num skill reutilizável
Dedup semanal de knowledge Sessão agendada mergeia/limpa conflitos de sugestões de knowledge
Guia de onboarding de equipe Devin lê seus próprios docs → um guia de primeiros passos para seu stack

Como usar este cookbook

  1. Escolha uma receita de Higiene agendada — é a primeira vitória mais barata (um loop noturno/semanal sobre o qual você para de pensar)
  2. Adicione uma de Incidentes se você tem PagerDuty/Datadog/Sentry
  3. Quando uma receita funciona, congele-a como um skill (Guia 12) ou um Bot (Guias 1–5) — cada linha acima sobrevive como um dos dois

Passo a passo real — uma receita executada de verdade, no Devin CLI v3000.14 (swe-2-flash-medium)

A receita Raise code coverage da prateleira Code quality, executada de ponta a ponta num repositório pequeno com um orders.py propositalmente sub-testado (códigos de desconto, faixas de frete, casos de borda). Um prompt de uma linha; o Devin fez o resto.

Vídeo (74 s, sem áudio): prompt da receita → leitura → edição dos testes → aprovação de comando → tudo verde.

Devin escrevendo os casos de teste que faltavam — diff de test_orders.py com o menu de permissão aberto

1. O REPL do CLI em swe-2-flash-medium — plano Pro, cota gratuita 1. O REPL do CLI em swe-2-flash-medium — plano Pro, cota gratuita

2. O prompt da receita enviado — Devin lê orders.py e test_orders.py antes de mexer 2. O prompt da receita enviado — primeiro lê orders.py e test_orders.py

3. Escrevendo testes — +43 linhas de casos novos: carrinho vazio, SAVE10/SAVE20/código desconhecido, toda faixa de frete 3. Escrevendo testes — +43 linhas cobrindo carrinho vazio, códigos de desconto e toda faixa de frete

4. Aprovação de comando — rodar a suíte também pede permissão 4. Aprovação de comando — python3 -m unittest -v test_orders.py espera um Allow

5. 11 testes passando — o relatório cita cada branch coberta; orders.py intacto, sem commits 5. 11 testes passando — cada branch antes sem teste citada; orders.py intacto, sem commits

6. Verificado após /exit — 16 testes verdes, mudanças continuam não commitadas 6. Verificado após /exit — Ran 16 tests ... OK, mudanças não commitadas como instruído

Checklist de verificação

Armadilhas

Teste de conhecimento

  1. Por que começar com uma receita de higiene agendada em vez de resposta a incidentes? (A vitória mais barata possível — roda enquanto você dorme, e uma correção de lint noturna errada é recuperável; uma ação de incidente errada não é.)
  2. O que "congelar uma receita como skill ou Bot" realmente previne? (Drift de prompt e dependência de pessoa única — a receita sobrevive a quem a escreveu.)
  3. Por que adaptar a parte de verificação de um prompt da galeria antes da parte da tarefa? (A tarefa descreve intenção; a checagem é o que seu repo consegue provar — checagens erradas produzem lixo confiante.)

Fontes