Pular para o conteúdo principal
Comandos personalizados permitem criar fluxos de trabalho reutilizáveis que podem ser disparados com um simples prefixo / na caixa de entrada do chat. Esses comandos ajudam a padronizar processos na tua equipe e tornam tarefas comuns mais eficientes.
Commands input example
Os comandos estão em beta. O recurso e a sintaxe podem mudar conforme a gente continua melhorando.

Como os comandos funcionam

Os comandos são definidos como arquivos Markdown simples que podem ser armazenados em dois locais:
  1. Comandos do projeto: armazenados no diretório .cursor/commands do teu projeto
  2. Comandos globais: armazenados no diretório ~/.cursor/commands no teu diretório inicial
Quando tu digita / na caixa de entrada do chat, o Cursor detecta e exibe automaticamente os comandos disponíveis de ambos os diretórios, deixando tudo acessível instantaneamente no teu fluxo de trabalho.

Criando comandos

  1. Cria um diretório .cursor/commands na raiz do teu projeto
  2. Adiciona arquivos .md com nomes descritivos (por exemplo, review-code.md, write-tests.md)
  3. Escreve conteúdo em Markdown simples descrevendo o que o comando deve fazer
  4. Os comandos vão aparecer automaticamente no chat quando tu digitar /
Aqui está um exemplo de como a estrutura do diretório de comandos pode ficar:
.cursor/
└── commands/
    ├── tratar-comentarios-de-pr-no-github.md
    ├── checklist-de-revisao-de-codigo.md
    ├── criar-pr.md
    ├── revisao-leve-de-diffs-existentes.md
    ├── onboarding-de-novo-desenvolvedor.md
    ├── executar-todos-os-testes-e-corrigir.md
    ├── auditoria-de-seguranca.md
    └── configurar-nova-feature.md

Exemplos

Testa esses comandos nos teus projetos pra sacar como eles funcionam.
# Checklist de Revisão de Código

## Visão geral
Checklist abrangente para realizar revisões de código completas e garantir qualidade, segurança e manutenção.

## Categorias de revisão

### Funcionalidade
- [ ] O código faz o que deveria
- [ ] Casos extremos estão cobertos
- [ ] O tratamento de erros é adequado
- [ ] Sem bugs óbvios ou erros de lógica

### Qualidade do código
- [ ] O código é legível e bem estruturado
- [ ] As funções são pequenas e focadas
- [ ] Os nomes de variáveis são descritivos
- [ ] Sem duplicação de código
- [ ] Segue as convenções do projeto

### Segurança
- [ ] Sem vulnerabilidades de segurança óbvias
- [ ] Há validação de entrada
- [ ] Dados sensíveis são tratados corretamente
- [ ] Sem segredos hardcoded
# Auditoria de Segurança

## Visão Geral
Revisão de segurança abrangente para identificar e corrigir vulnerabilidades na base de código.

## Etapas
1. **Auditoria de dependências**
   - Verificar vulnerabilidades conhecidas
   - Atualizar pacotes desatualizados
   - Revisar dependências de terceiros

2. **Revisão de segurança do código**
   - Verificar vulnerabilidades comuns
   - Revisar autenticação/autorização
   - Auditar práticas de manejo de dados

3. **Segurança de infraestrutura**
   - Revisar variáveis de ambiente
   - Verificar controles de acesso
   - Auditar segurança de rede

## Checklist de Segurança
- [ ] Dependências atualizadas e seguras
- [ ] Nenhum segredo embutido em código
- [ ] Validação de entrada implementada
- [ ] Autenticação segura
- [ ] Autorização configurada corretamente
# Configurar nova feature

## Visão geral
Configura uma nova feature de forma sistemática, do planejamento inicial à estrutura de implementação.

## Etapas
1. **Definir requisitos**
   - Esclarecer escopo e objetivos da feature
   - Identificar user stories e critérios de aceitação
   - Planejar a abordagem técnica

2. **Criar branch da feature**
   - Criar branch a partir de main/develop
   - Configurar o ambiente de desenvolvimento local
   - Configurar novas dependências, se houver

3. **Planejar a arquitetura**
   - Definir modelos de dados e APIs
   - Planejar componentes de UI e fluxo
   - Definir a estratégia de testes

## Checklist de setup da feature
- [ ] Requisitos documentados
- [ ] User stories escritas
- [ ] Abordagem técnica planejada
- [ ] Branch da feature criado
- [ ] Ambiente de desenvolvimento pronto
# Criar PR

## Visão geral
Cria um pull request bem estruturado, com descrição adequada, rótulos e revisores.

## Etapas
1. **Preparar a branch**
   - Garante que todas as alterações estejam commitadas
   - Faz push da branch para o remoto
   - Verifica se a branch está atualizada com a main

2. **Escrever a descrição do PR**
   - Resume as alterações de forma clara
   - Inclui contexto e motivação
   - Lista quaisquer breaking changes
   - Adiciona screenshots se houver mudanças na UI

3. **Configurar o PR**
   - Cria o PR com um título descritivo
   - Adiciona rótulos apropriados
   - Atribui revisores
   - Vincula issues relacionadas

## Template de PR
- [ ] Feature A
- [ ] Correção de bug B
- [ ] Testes unitários passando
- [ ] Testes manuais concluídos
# Executar Todos os Testes e Corrigir Falhas

## Visão geral
Executa a suíte completa de testes e corrige sistematicamente quaisquer falhas, garantindo a qualidade e a funcionalidade do código.

## Etapas
1. **Executar a suíte de testes**
   - Executa todos os testes do projeto
   - Captura o output e identifica falhas
   - Verifica tanto testes unitários quanto de integração

2. **Analisar falhas**
   - Categoriza por tipo: flaky (instáveis), quebradas, novas falhas
   - Prioriza correções com base no impacto
   - Verifica se as falhas estão relacionadas a alterações recentes

3. **Corrigir problemas de forma sistemática**
   - Começa pelas falhas mais críticas
   - Corrige um problema por vez
   - Reexecuta os testes após cada correção
# Onboarding de Novo Desenvolvedor

## Visão geral
Processo de onboarding completo para deixar um novo desenvolvedor pronto para começar rapidamente.

## Etapas
1. **Configuração do ambiente**
   - Instalar as ferramentas necessárias
   - Configurar o ambiente de desenvolvimento
   - Configurar IDE e extensões
   - Configurar Git e chaves SSH

2. **Familiarização com o projeto**
   - Revisar a estrutura do projeto
   - Entender a arquitetura
   - Ler a documentação principal
   - Configurar o banco de dados local

## Checklist de Onboarding
- [ ] Ambiente de desenvolvimento pronto
- [ ] Todos os testes passando
- [ ] Conseguindo rodar a aplicação localmente
- [ ] Banco de dados configurado e funcionando
- [ ] Primeiro PR enviado
I