Skills: Skills de Workflow Multi-Etapas
Última atualização: 2026-08-31
Tarefas complexas não podem ser concluídas em uma única etapa — Skills multi-etapas codificam "como decompor, como encadear e o que fazer quando algo dá errado" no processo.
1. Princípios de Design de Workflow
(1) Decomposição de Tarefas
Princípios de Decomposição de Tarefas
├── Cada etapa tem entrada e saída claras
├── Cada etapa é independentemente verificável
├── Dependências entre etapas são claras
├── Etapas críticas têm pontos de verificação
└── Exceções têm planos de contingência
(2) Tipos de Etapas
| Tipo | Descrição | Exemplo |
|---|---|---|
| Sequencial | Devem executar em ordem | Instalar dependências depois compilar |
| Condicional | Executa apenas quando a condição é atendida | Entrar em depuração somente quando testes falham |
| Opcional | Pode ser pulada | Geração de documentação |
| Loop | Executa repetidamente | Processar arquivos em lote |
| Ponto de verificação | Confirmação de estado e snapshot | Verificação pós-build |
2. Orquestração de Workflow
(1) Workflow Linear
Execução sequencial mais simples:
Workflow de Desenvolvimento de Nova Funcionalidade
1. Análise de requisitos → Saída: Documento de requisitos
2. Design técnico → Saída: Documento de design
3. Implementação de código → Saída: Código-fonte
4. Testes unitários → Saída: Relatório de testes
5. Revisão de código → Saída: Comentários da revisão
6. Merge e deploy → Saída: Status de implantação
(2) Workflow com Branch Condicional
Workflow de Implantação
1. Pré-verificação
2. Executar testes
3. Verificação de condição:
- Testes passam → Continuar implantação
- Testes falham → Depurar e corrigir → Voltar à etapa 2
4. Deploy para staging
5. Health check:
- Passou → Perguntar se deve fazer deploy para produção
- Falhou → Rollback + notificar
(3) Workflow Paralelo
Exemplo de Tarefa Paralela
┌→ Testes Unitários ─┐
Pré-check ──┤→ Revisão de Código ─┤→ Agregar resultados → Deploy
└→ Scan de Segurança ─┘
3. Tratamento de Exceções e Recuperação
(1) Classificação de Erros
| Nível | Estratégia de Tratamento | Exemplo |
|---|---|---|
| 🟢 Ignorável | Registrar e continuar | Avisos não críticos |
| 🟡 Retentável | Tentar N vezes depois escalar | Timeout de rede |
| 🔴 Deve Parar | Rollback para ponto de verificação, notificar humano | Perda de dados |
(2) Mecanismo de Ponto de Verificação
## Configuração de Ponto de Verificação
1. Antes de etapas críticas: git commit para salvar estado
2. Antes de operações perigosas: Confirmar intenção do usuário
3. Antes de operações irreversíveis: Criar backup
4. Após cada fase: Gerar relatório de progresso
(3) Recuperação de Interrupção
## Fluxo de Recuperação de Interrupção
1. Ler último registro de progresso
2. Confirmar etapas concluídas
3. Continuar da etapa incompleta
4. Verificar estado das etapas concluídas
4. Prática de Skill de Workflow
▶ Exemplo: Workflow de Release
Alice criou uma Skill padronizada de release de versão:
---
name: release-workflow
description: "Workflow de release de versão"
triggers:
- keyword: "release"
tools:
- Read
- Write
- Edit
- Bash
- Grep
---
## Fluxo de Release
1. Bash: git status (confirmar working tree limpa)
2. Bash: npm test (suite de testes completa)
3. Edit: Atualizar número de versão
4. Bash: git tag + git push
5. Write: Gerar CHANGELOG
6. Bash: npm run build
7. Bash: Deploy para staging + health check
8. Confirmar e então fazer deploy para produção
Bob disse: "O maior medo em releases é pular etapas — Skills travam o processo para que você não possa esquecer de rodar os testes antes de ir para produção."
❓ Perguntas Frequentes
P: Muitas etapas afetam a performance? R: Sim. Recomendamos no máximo 8 etapas principais e no máximo 3 pontos de verificação. Para mais etapas, considere dividir em múltiplas Skills encadeadas. P: Como se recuperar após uma interrupção? R: Cada etapa crítica gera um registro de estado (arquivo ou log); após a interrupção, leia o registro para determinar o ponto de recuperação. P: Branches condicionais tornam os workflows muito complexos? R: Sim. Recomendamos no máximo 3 branches e no máximo 2 níveis de aninhamento. Para lógica mais complexa, considere dividir em Skills independentes.
📖 Resumo
- Princípios de design: Cada etapa tem entrada/saída clara, é verificável, tem plano de contingência
- Três tipos de orquestração: linear, branch condicional, paralelo
- Tratamento de exceções: Classificação de erros, mecanismo de ponto de verificação, recuperação de interrupção
- Conselhos práticos: Etapas <8, branches <3, aninhamento <2
📝 Exercícios
- Básico (⭐): Crie uma Skill de workflow linear implementando o processo de três etapas "testar → compilar → deploy".
- Intermediário (⭐⭐): Crie uma Skill de workflow com branch condicional que entra automaticamente no fluxo de depuração quando os testes falham.
- Avançado (⭐⭐⭐): Crie uma Skill de release completa com pontos de verificação, recuperação de exceções e mecanismos de rollback.
