tdd-workflow
Faz seu agente seguir os princípios do desenvolvimento guiado por testes. Ele foca no ciclo de escrever testes, fazer código passar e refatorar.
O que ela faz
Essa habilidade ajuda a criar código de forma organizada e confiável. Ela ensina um ciclo onde você primeiro escreve um teste que falha, depois o código mínimo para fazê-lo passar, e por fim melhora o código.
Quando usar
- ✓Ao iniciar uma nova funcionalidade.
- ✓Ao corrigir um erro.
- ✓Ao trabalhar com lógica complicada.
Exemplo do que pedir para a IA
“Me ajude a aplicar o ciclo TDD para criar uma função que soma dois números.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A IA segue um ciclo: primeiro, você descreve o que o código deve fazer e a IA escreve um teste que falha. Depois, a IA escreve o código mais simples para o teste passar. Por fim, a IA revisa e melhora o código sem quebrar os testes.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill tdd-workflowOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/tdd-workflow/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Fluxo de Trabalho TDD
Escreva testes primeiro, código depois.
1. O Ciclo TDD
🔴 RED → Write failing test
↓
🟢 GREEN → Write minimal code to pass
↓
🔵 REFACTOR → Improve code quality
↓
Repeat...
2. As Três Leis do TDD
- Escreva código de produção apenas para fazer um teste falhar passar.
- Escreva apenas o teste suficiente para demonstrar a falha.
- Escreva apenas o código suficiente para fazer o teste passar.
3. Princípios da Fase VERMELHO (RED)
O Que Escrever
| Foco | Exemplo |
|---|---|
| Comportamento | "deve somar dois números" |
| Casos de borda | "deve lidar com entrada vazia" |
| Estados de erro | "deve lançar exceção para dados inválidos" |
Regras da Fase VERMELHO (RED)
- O teste deve falhar primeiro.
- O nome do teste descreve o comportamento esperado.
- Uma asserção por teste (idealmente).
4. Princípios da Fase VERDE (GREEN)
Código Mínimo
| Princípio | Significado |
|---|---|
| YAGNI | Você Não Vai Precisar Disso (You Aren't Gonna Need It) |
| Coisa Mais Simples | Escreva o mínimo para passar |
| Sem Otimização | Apenas faça funcionar |
Regras da Fase VERDE (GREEN)
- Não escreva código desnecessário.
- Não otimize ainda.
- Faça o teste passar, nada mais.
5. Princípios da Fase REFAZ (REFACTOR)
O Que Melhorar
| Área | Ação |
|---|---|
| Duplicação | Extrair código comum |
| Nomenclatura | Tornar a intenção clara |
| Estrutura | Melhorar a organização |
| Complexidade | Simplificar a lógica |
Regras da Fase REFAZ (REFACTOR)
- Todos os testes devem permanecer verdes.
- Pequenas mudanças incrementais.
- Commit após cada refatoração.
6. Padrão AAA
Todo teste segue:
| Etapa | Propósito |
|---|---|
| Arrange (Organizar) | Preparar os dados de teste |
| Act (Agir) | Executar o código sob teste |
| Assert (Verificar) | Validar o resultado esperado |
7. Quando Usar TDD
| Cenário | Valor do TDD |
|---|---|
| Nova funcionalidade | Alto |
| Correção de bug | Alto (escreva o teste primeiro) |
| Lógica complexa | Alto |
| Exploratório | Baixo (spike, depois TDD) |
| Layout de UI | Baixo |
8. Priorização de Testes
| Prioridade | Tipo de Teste |
|---|---|
| 1 | Caminho feliz (Happy path) |
| 2 | Casos de erro |
| 3 | Casos de borda |
| 4 | Desempenho |
9. Anti-Padrões
| ❌ Não Fazer | ✅ Fazer |
|---|---|
| Pular a fase VERMELHO (RED) | Observar o teste falhar primeiro |
| Escrever testes depois | Escrever testes antes |
| Superengenharia inicial | Manter simples |
| Múltiplas asserções | Um comportamento por teste |
| Testar implementação | Testar comportamento |
10. TDD Aumentado por IA
Padrão Multi-Agente
| Agente | Papel |
|---|---|
| Agente A | Escrever testes falhando (VERMELHO) |
| Agente B | Implementar para passar (VERDE) |
| Agente C | Otimizar (REFAZ) |
Lembre-se: O teste é a especificação. Se você não consegue escrever um teste, não entende o requisito.
Quando Usar
Esta habilidade é aplicável para executar o fluxo de trabalho ou as ações descritas na visão geral.
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
- Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.
Perguntas frequentes
O que significa 'RED', 'GREEN', 'REFACTOR'?
'RED' é quando o teste falha. 'GREEN' é quando o código faz o teste passar. 'REFACTOR' é quando você melhora o código mantendo tudo funcionando.
Por que escrever o teste antes do código?
Escrever o teste primeiro garante que você sabe exatamente o que o código precisa fazer e ajuda a evitar código desnecessário.
O que é 'YAGNI'?
YAGNI significa 'Você Não Vai Precisar Disso'. É um princípio para escrever apenas o código estritamente necessário no momento.
Detalhes
Descrição original do autor
Test-Driven Development workflow principles. RED-GREEN-REFACTOR cycle.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #4319
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
cpp-testing
Faz seu agente escrever e melhorar testes para código C++. Ajuda a configurar ferramentas de teste e a corrigir erros.
affaan-m/ECC
csharp-testing
Ajuda seu agente a criar testes para código C# e .NET. Ele usa as melhores práticas para garantir que os testes sejam eficientes e confiáveis.
affaan-m/ECC
django-tdd
Faz seu agente aplicar estratégias de teste para Django com pytest-django e TDD. É útil para escrever testes robustos e garantir a qualidade do código, especialmente para APIs DRF.
affaan-m/ECC