Skip to main content

Cursor Commands – Automação e Produtividade no Dia a Dia

· 6 min read
Bruno Carneiro
Bruno Carneiro
Fundador da @TautornTech

Enquanto Rules definem padrões e Agents executam tarefas complexas, Commands (Comandos) são workflows reutilizáveis que padronizam processos comuns. Eles transformam tarefas repetitivas em comandos simples com o prefixo /.

O que são Cursor 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.

Eles são perfeitos para:

  • Checklists padronizados: Code review, security audit
  • Workflows de desenvolvimento: Setup de features, criação de PRs
  • Processos de qualidade: Testes, validações
  • Onboarding: Configuração de ambiente

Onde Commands são Armazenados?​

Commands podem estar em três locais:

1. Project Commands​

Armazenados em .cursor/commands/ do projeto. Específicos para o projeto e versionados com Git.

2. Global Commands​

Armazenados em ~/.cursor/commands/ no seu diretório home. Disponíveis em todos os projetos.

3. Team Commands​

Criados por admins no Cursor Dashboard. Disponíveis automaticamente para todos os membros do time (planos Team e Enterprise).

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

## Checklist
- [ ] Dependências atualizadas e seguras
- [ ] Sem secrets hardcoded
- [ ] Validação de inputs implementada
- [ ] Autenticação segura
- [ ] Autorização configurada corretamente

Uso:

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

3. Setup New Feature​

# Setup New Feature

## Overview
Configurar sistematicamente uma nova feature do planejamento à estrutura de implementação.

## 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 e APIs
   - Planejar componentes UI e fluxo
   - Considerar estratégia de testes

## Checklist
- [ ] Requisitos documentados
- [ ] User stories escritas
- [ ] Abordagem técnica planejada
- [ ] Feature branch criada
- [ ] Ambiente de desenvolvimento pronto

Uso:

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

4. Create Pull Request​

# Create PR

## Overview
Criar um pull request bem estruturado com descrição adequada, labels e revisores.

## Passos

1. **Preparar branch**
   - Garantir que todas mudanças estão commitadas
   - Push da branch para remote
   - Verificar se branch está atualizada

2. **Escrever descrição**
   - Resumir mudanças claramente
   - Incluir contexto e motivação
   - Listar breaking changes
   - Adicionar screenshots se mudanças de UI

3. **Configurar PR**
   - Criar PR com título descritivo
   - Adicionar labels apropriados
   - Atribuir revisores
   - Linkar issues relacionados

## Template
- [ ] Feature A
- [ ] Bug fix B
- [ ] Testes unitários passando
- [ ] Testes manuais completos

Uso:

/create-pr Para feature de autenticação, inclui screenshots

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 que são automaticamente sincronizados para todos os membros:

  1. Acesse Team Content Dashboard
  2. Crie um novo Command
  3. Defina:
    • Nome: Nome do comando (aparece após /)
    • Descrição: Contexto sobre o que faz
    • Conteúdo: Markdown com o workflow

Benefícios:

  • Gerenciamento centralizado: Atualize uma vez, todos recebem
  • Padronização: Garante workflows consistentes
  • Fácil compartilhamento: Sem necessidade de distribuir arquivos
  • Controle de acesso: Apenas admins podem criar/modificar

Benefícios no Dia a Dia​

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

Conclusão​

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

Ao criar Commands bem estruturados, você:

  • Padroniza processos do time
  • Aumenta produtividade
  • Melhora qualidade
  • Facilita colaboração

No próximo artigo, vamos ver um case study completo de como usamos Agents, Rules e Commands juntos para criar um sistema de documentação automatizado.

Próximos Passos​

  • Crie seu primeiro Command para um processo comum
  • Explore Team Commands se tiver plano Team/Enterprise
  • Combine Commands com Rules para máxima eficiência
  • Leia o Case Study completo
tip

Aprofunde seu Conhecimento​

Quer aprender mais sobre Cursor? Explore nossa trilha completa de documentação:

Artigos Relacionados:

Referências: