Skip to main content

Cursor Commands

Commands são workflows reutilizáveis que padronizam processos comuns. Eles transformam tarefas repetitivas em comandos simples com o prefixo /, aumentando produtividade e garantindo consistência.

O que são Commands?​

Commands são arquivos Markdown que definem workflows reutilizáveis. Ao digitar / no chat, você vê todos os comandos disponíveis e pode executá-los com contexto adicional.

Ideal para:

  • Checklists padronizados
  • Workflows de desenvolvimento
  • Processos de qualidade
  • Automação de tarefas

Onde Commands são Armazenados?​

1. Project Commands​

Armazenados em .cursor/commands/ do projeto.

  • Específicos para o projeto
  • Versionados com Git
  • Compartilhados com o time

2. Global Commands​

Armazenados em ~/.cursor/commands/ no diretório home.

  • Disponíveis em todos os projetos
  • Pessoais e reutilizáveis
  • Não versionados

3. Team Commands​

Criados por admins no Cursor Dashboard.

  • Disponíveis para todo o time
  • Gerenciados centralmente
  • Sincronizados automaticamente

Estrutura de um Command​

Commands são simples arquivos Markdown:

.cursor/commands/
├── code-review.md
├── create-pr.md
├── security-audit.md
└── setup-feature.md

Exemplo Básico​

# Code Review Checklist

## Overview
Checklist completo para revisão de código garantindo qualidade, segurança e manutenibilidade.

## Review Categories

### Functionality
- [ ] Código faz o que deveria fazer
- [ ] Casos extremos são tratados
- [ ] Tratamento de erros apropriado
- [ ] Sem bugs óbvios

### Code Quality
- [ ] Código é legível e bem estruturado
- [ ] Funções são pequenas e focadas
- [ ] Nomes de variáveis são descritivos
- [ ] Sem duplicação de código
- [ ] Segue convenções do projeto

Exemplos Práticos​

1. Code Review Checklist​

# Code Review Checklist

## Overview
Checklist abrangente para revisão de código.

## Categorias

### Funcionalidade
- [ ] Código funciona como esperado
- [ ] Edge cases tratados
- [ ] Error handling adequado
- [ ] Sem bugs óbvios

### Qualidade
- [ ] Código legível
- [ ] Funções pequenas e focadas
- [ ] Nomes descritivos
- [ ] Sem duplicação
- [ ] Segue padrões do projeto

### Segurança
- [ ] Sem vulnerabilidades óbvias
- [ ] Validação de inputs
- [ ] Dados sensíveis protegidos
- [ ] Sem secrets hardcoded

Uso:

/code-review Revise o PR #123 focando em segurança

2. Security Audit​

# Security Audit

## Overview
Revisão de segurança para identificar e corrigir vulnerabilidades.

## Passos

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

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

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

Uso:

/security-audit Foque em autenticação e autorização

3. Setup New Feature​

# Setup New Feature

## Overview
Configurar sistematicamente uma nova feature.

## Passos

1. **Definir requisitos**
   - Esclarecer escopo e objetivos
   - Identificar user stories
   - Planejar abordagem técnica

2. **Criar feature branch**
   - Branch de main/develop
   - Configurar ambiente local
   - Configurar dependências

3. **Planejar arquitetura**
   - Design de modelos de dados
   - Planejar componentes UI
   - Considerar estratégia de testes

Uso:

/setup-feature Feature de autenticação com OAuth

Parâmetros e Contexto​

Você pode passar contexto adicional para os Commands:

/code-review Foque em performance e segurança do endpoint /api/users

O Agent receberá o conteúdo do Command mais o contexto adicional que você forneceu.

Team Commands​

Para times (planos Team e Enterprise), admins podem criar Commands no dashboard:

  1. Acesse Team Content Dashboard
  2. Crie um novo Command
  3. Defina nome, descrição e conteúdo

Benefícios:

  • Gerenciamento centralizado
  • Padronização garantida
  • Sincronização automática
  • Controle de acesso

Benefícios​

Padronização​

  • Todos seguem os mesmos processos
  • Checklists consistentes
  • Menos esquecimentos

Produtividade​

  • Workflows complexos em um comando
  • Menos tempo explicando processos
  • Automação de tarefas repetitivas

Qualidade​

  • Nada é esquecido em reviews
  • Processos de segurança padronizados
  • Onboarding mais rápido

Colaboração​

  • Time alinhado em processos
  • Fácil compartilhamento de conhecimento
  • Documentação viva

Combinando Commands com Rules​

Commands funcionam ainda melhor quando combinados com Rules:

  1. Rules definem padrões e convenções
  2. Commands executam workflows usando esses padrões

Exemplo:

  • Rule define: "Sempre use TypeScript, siga padrões de nomenclatura"
  • Command /setup-feature usa essas Rules ao criar nova feature

Best Practices​

✅ DO​

  • Seja específico: Instruções claras e acionáveis
  • Use checklists: Facilita seguir o processo
  • Inclua contexto: Explique o "porquê"
  • Mantenha atualizado: Revise e melhore regularmente
  • Compartilhe: Coloque no Git para o time

❌ DON'T​

  • Não seja vago: Evite instruções genéricas
  • Não exagere: Commands muito longos são menos úteis
  • Não duplique: Reutilize quando possível
  • Não ignore feedback: Melhore baseado no uso

Artigos Relacionados​

Para mais detalhes sobre Commands, confira:

Conclusão​

Commands são uma forma poderosa de padronizar workflows e aumentar produtividade. Eles transformam processos complexos em comandos simples, garantindo consistência e qualidade.

No próximo capítulo, vamos ver casos práticos de como usar Agents, Rules e Commands juntos.

Próximo: Casos Práticos