Workflows — slash commands prontos para usar
· 9 min para ler
Workflows são receitas reutilizáveis que ensinam o agente a executar tarefas complexas de forma padronizada. Cada workflow abaixo pode ser salvo e chamado com um slash command.
/investigar-bug
O que faz: analisa um erro ou comportamento inesperado, localiza a causa raiz e proposta de correção — sem alterar nada até você aprovar.
Investigar bug
name = "investigar-bug"
description = "Investiga um bug ou erro: loca causa raiz e propõe correção sem alterar código"
prompt = """
Você é um detetive de código. Sua missão é investigar o problema descrito pelo usuário sem alterar nenhum arquivo.
Passos obrigatórios:
1. Leia os arquivos relevantes para entender o contexto
2. Reproduza mentalmente o fluxo que causa o erro
3. Identifique a causa raiz (não apenas o sintoma)
4. Liste todas as linhas/funções envolvidas no problema
5. Proponha UMA correção clara e simples
6. Salve o relatório em artifacts/bug-report-YYYYMMDD.md
7. Pergunte ao usuário: "Posso aplicar a correção?"
NUNCA altere código antes da aprovação.
Problema relatado: args
"""
<!-- Antigravity: salve como investigar-bug.md nos Workflows -->
# Workflow: investigar-bug
Investigue o problema descrito sem alterar nenhum arquivo.
## Passos obrigatórios
1. Leia os arquivos relevantes para entender o contexto
2. Reproduza mentalmente o fluxo que causa o erro
3. Identifique a causa raiz, não apenas o sintoma
4. Liste linhas, arquivos e funções envolvidos
5. Proponha uma correção clara e simples
6. Salve o relatório em `artifacts/bug-report-YYYYMMDD.md`
7. Pergunte ao usuário: "Posso aplicar a correção?"
Não altere código antes da aprovação.
Exemplo de uso
/investigar-bug o script leitura_ifc.py trava quando o arquivo IFC tem mais de 500 elementos
/planejar
O que faz: transforma uma ideia ou pedido em um plano estruturado com passos, riscos e estimativa — salvo em /plans para aprovação antes de qualquer execução.
Planejar
# .gemini/commands/planejar.toml
name = "planejar"
description = "Cria um plano estruturado para uma tarefa e salva em /plans para aprovação"
prompt = """
Crie um plano detalhado para a tarefa descrita. Não execute nada — apenas planeje.
Estrutura do plano:
1. **Objetivo:** o que será entregue
2. **Arquivos que serão criados ou modificados** (liste todos)
3. **Passos em ordem** (numere cada um)
4. **Dependências** (o que precisa estar pronto antes)
5. **Riscos identificados** (o que pode dar errado)
6. **Estimativa** (simples/médio/complexo e por quê)
Salve o plano em plans/plano-YYYYMMDD-[nome-curto].md
Apresente o plano ao usuário e pergunte: "Este plano está correto? Posso prosseguir?"
Tarefa: args
"""
<!-- Antigravity: salve como planejar.md nos Workflows -->
# Workflow: planejar
Crie um plano detalhado para a tarefa descrita. Não execute nada, apenas planeje.
## Estrutura do plano
1. Objetivo do que será entregue
2. Arquivos que serão criados ou modificados
3. Passos em ordem
4. Dependências
5. Riscos identificados
6. Estimativa: simples, médio ou complexo, com justificativa
Salve o plano em `plans/plano-YYYYMMDD-[nome-curto].md`.
Apresente o plano ao usuário e pergunte: "Este plano está correto? Posso prosseguir?"
Exemplo de uso
/planejar criar um script Python que lê um arquivo IFC e exporta uma planilha com todos os elementos e suas propriedades
/executar
O que faz: executa uma tarefa já aprovada (idealmente a partir de um plano existente em /plans), reportando cada passo concluído.
Executar
# .gemini/commands/executar.toml
name = "executar"
description = "Executa uma tarefa aprovada, passo a passo, com reporte de progresso"
prompt = """
Execute a tarefa descrita. Se existir um arquivo de plano em plans/ relacionado a essa tarefa, leia-o primeiro.
Regras de execução:
- Execute um passo de cada vez
- Após cada passo, informe: "✅ Passo X concluído: [o que foi feito]"
- Se algo inesperado acontecer, PARE e informe o usuário antes de continuar
- Não modifique arquivos fora do escopo da tarefa
- Ao terminar, salve um resumo em artifacts/execucao-YYYYMMDD.md com o que foi feito
Tarefa: args
"""
<!-- Antigravity: salve como executar.md nos Workflows -->
# Workflow: executar
Execute a tarefa descrita. Leia o plano em `plans/` se existir.
## Regras
- Execute um passo de cada vez
- Reporte: "✅ Passo X concluído: [o que foi feito]"
- Se algo inesperado acontecer, PARE e avise
- Não modifique arquivos fora do escopo
- Ao terminar, salve resumo em `artifacts/execucao-YYYYMMDD.md`
Exemplo de uso
/executar criar o script de exportação IFC conforme plano aprovado
Output esperado: arquivos criados conforme o plano + artifacts/execucao-20260324.md com resumo do que foi feito.
/testar
O que faz: executa testes em um script ou função existente com um arquivo de exemplo real, mostra o resultado e indica se passou ou falhou.
Testar
# .gemini/commands/testar.toml
name = "testar"
description = "Testa um script ou função com dados reais e reporta o resultado"
prompt = """
Execute um teste funcional no arquivo ou função indicada.
Passos:
1. Leia o código do arquivo indicado
2. Identifique o que ele deveria fazer
3. Rode o script com um arquivo de entrada de exemplo (se disponível na pasta)
4. Capture o output ou erro
5. Compare com o resultado esperado
6. Classifique: ✅ PASSOU ou ❌ FALHOU
7. Se falhou: descreva o problema e sugira a correção
8. Salve o resultado em artifacts/teste-YYYYMMDD.md
Arquivo/função a testar: args
"""
<!-- Antigravity: salve como testar.md nos Workflows -->
# Workflow: testar
Execute um teste funcional no arquivo indicado.
## Passos
1. Leia o código do arquivo
2. Identifique o que ele deveria fazer
3. Rode com arquivo de exemplo disponível
4. Capture output ou erro
5. Classifique: ✅ PASSOU ou ❌ FALHOU
6. Se falhou: descreva o problema e sugira correção
7. Salve em `artifacts/teste-YYYYMMDD.md`
Exemplo de uso
/testar leitura_ifc.py usando o arquivo modelo.ifc que está na pasta /exemplos
Output esperado: artifacts/teste-20260324.md com resultado ✅ PASSOU ou ❌ FALHOU, output capturado e sugestão de correção se necessário.
/criar-testes
O que faz: lê um script existente e gera automaticamente um arquivo de testes unitários cobrindo os casos principais — sem modificar o script original.
Criar testes
# .gemini/commands/criar-testes.toml
name = "criar-testes"
description = "Gera arquivo de testes unitários para um script existente"
prompt = """
Analise o arquivo indicado e crie testes unitários para ele.
Passos:
1. Leia o código do arquivo
2. Identifique todas as funções/comportamentos que podem ser testados
3. Para cada função, crie testes para:
- Caso normal (entrada válida esperada)
- Caso de borda (entrada vazia, zero, lista vazia, etc.)
- Caso de erro (entrada inválida ou arquivo inexistente)
4. Use a biblioteca `pytest` para Python
5. Adicione comentários em português explicando o que cada teste verifica
6. Salve o arquivo como artifacts/test_[nome-original].py
7. Informe quantos testes foram criados e quais casos foram cobertos
Arquivo a testar: args
"""
<!-- Antigravity: salve como criar-testes.md nos Workflows -->
# Workflow: criar-testes
Gere testes unitários para o arquivo indicado. Não modifique o arquivo original.
## Passos
1. Leia o código
2. Identifique funções/comportamentos testáveis
3. Para cada função, crie testes: caso normal, borda e erro
4. Use `pytest` para Python
5. Comentários em português explicando cada teste
6. Salve como `artifacts/test_[nome-original].py`
7. Informe quantos testes e quais casos foram cobertos
Exemplo de uso
/criar-testes leitura_ifc.py
Output esperado: artifacts/test_leitura_ifc.py com testes completos prontos para rodar com pytest.
/documentar
O que faz: lê um script e gera documentação clara em português explicando o que ele faz, como usar e quais são os parâmetros.
Documentar
# .gemini/commands/documentar.toml
name = "documentar"
description = "Gera documentação em português para um script existente"
prompt = """
Leia o arquivo indicado e crie uma documentação completa em português.
Estrutura da documentação:
1. **O que este script faz** (1 parágrafo simples, sem jargão)
2. **Como usar** (comando exato para rodar)
3. **Parâmetros e entradas** (o que precisa fornecer)
4. **O que o script gera** (output esperado)
5. **Exemplo prático completo**
6. **Erros comuns e como resolver**
Salve como artifacts/docs-[nome-do-arquivo].md
Escreva como se fosse explicar para alguém que nunca programou.
Arquivo: args
"""
<!-- Antigravity: salve como documentar.md nos Workflows -->
# Workflow: documentar
Crie documentação em português para o arquivo indicado.
## Estrutura
1. O que este script faz (linguagem simples)
2. Como usar (comando exato)
3. Parâmetros e entradas
4. O que gera (output esperado)
5. Exemplo prático completo
6. Erros comuns e como resolver
Salve como `artifacts/docs-[nome].md`
Escreva para quem nunca programou.
Exemplo de uso
/documentar exportar_planilha.py
Output esperado: artifacts/docs-exportar_planilha.md com documentação completa pronta para compartilhar com a equipe.
/revisar-codigo
O que faz: revisa um script e aponta problemas de qualidade, segurança e boas práticas — sem alterar nada, apenas sugere melhorias.
Revisar código
# .gemini/commands/revisar-codigo.toml
name = "revisar-codigo"
description = "Revisa um script e aponta problemas de qualidade e segurança sem alterar nada"
prompt = """
Faça uma revisão de código no arquivo indicado. Não altere nenhum arquivo.
Verifique e aponte problemas em:
1. **Clareza:** o código é fácil de entender? Variáveis têm nomes claros?
2. **Segurança:** há senhas, tokens ou dados sensíveis expostos no código?
3. **Erros silenciosos:** há trechos que podem falhar sem avisar o usuário?
4. **Eficiência:** há algo que pode ser simplificado sem perder funcionalidade?
5. **Boas práticas:** o código segue o padrão da linguagem?
Formato do resultado:
- ✅ O que está bom
- ⚠️ O que precisa de atenção (com linha do arquivo)
- ❌ O que deve ser corrigido (com sugestão)
Salve o relatório em artifacts/revisao-[nome].md
Pergunte ao usuário se quer aplicar as correções sugeridas.
Arquivo: args
"""
<!-- Antigravity: salve como revisar-codigo.md nos Workflows -->
# Workflow: revisar-codigo
Revise o arquivo indicado. Não altere nada.
## Verifique
1. Clareza: nomes de variáveis, legibilidade
2. Segurança: senhas ou tokens expostos
3. Erros silenciosos: falhas sem aviso
4. Eficiência: simplificações possíveis
5. Boas práticas da linguagem
## Formato
- ✅ O que está bom
- ⚠️ Atenção (com linha)
- ❌ Deve corrigir (com sugestão)
Salve em `artifacts/revisao-[nome].md`
Pergunte se quer aplicar as correções.
Exemplo de uso
/revisar-codigo leitura_ifc.py
Output esperado: artifacts/revisao-leitura_ifc.md com itens classificados em ✅ bom / ⚠️ atenção / ❌ corrigir.
Estrutura de pastas recomendada
meu-projeto/
├── gemini.md ← instruções gerais do agente
├── .gemini/
│ └── commands/ ← workflows do Gemini CLI (.toml)
├── plans/ ← planos gerados pelo /planejar
├── regras/
│ └── regras-de-negocio.md ← regras do projeto
├── artifacts/ ← outputs gerados pelos workflows
└── (código do projeto)