Pular para o conteúdo principal

Melhores práticas e solução de problemas das regras MDC

dica

As regras MDC (Model-Driven Code) ajudam você a manter uma qualidade de código consistente e automatizar tarefas repetitivas no Cursor.

Entendendo as regras MDC​

As regras MDC são ferramentas poderosas que permitem:

  • Automatizar revisões de código e formatação
  • Implementar padrões de codificação da equipe
  • Detectar e corrigir problemas comuns
  • Melhorar a qualidade e consistência do código

Tipos de regras​

  1. Regras sintáticas

    • Formatação de código
    • Convenções de nomenclatura
    • Estrutura de arquivos

  2. Regras semânticas

    • Complexidade do código
    • Verificação de melhores práticas
    • Detecção de vulnerabilidades de segurança

  3. Regras personalizadas

    • Requisitos específicos do projeto
    • Convenções da equipe
    • Validação de lógica de negócios

Configuração de regras​

Configuração básica​

Crie um diretório .cursor/rules na raiz do projeto:

mkdir -p .cursor/rules

Definição de regras​

Crie um arquivo de regras:

.cursor/rules/naming.json
{
  "name": "Convenção de nomenclatura",
  "description": "Aplica um estilo de nomenclatura consistente",
  "patterns": [
    {
      "type": "variável",
      "style": "camelCase",
      "exceptions": ["CONSTANTS"]
    }
  ]
}

Prioridade de regras​

Defina a prioridade das regras de acordo com a importância:

.cursor/rules/config.json
{
  "priority": {
    "security": 1,
    "formatting": 2,
    "naming": 3
  }
}

Problemas comuns e soluções​

Regras não aplicadas​

Se as regras não estão sendo aplicadas:

  1. Verificar configuração

    # Validar arquivo de regras
    cat .cursor/rules/config.json

    # Verificar erros de sintaxe
    jsonlint .cursor/rules/*.json

  2. Atualizar cache de regras

    • Reiniciar o Cursor
    • Limpar cache de regras
    • Recarregar projeto

Conflitos de regras​

Gerenciar conflitos de regras:

.cursor/rules/override.json
{
  "conflicts": {
    "rule1": {
      "priority": "high",
      "override": ["rule2", "rule3"]
    }
  }
}

Problemas de desempenho​

Otimizar a execução de regras:

  1. Limitar escopo

    {
      "include": ["src/**/*.ts"],
      "exclude": ["**/*.test.ts"]
    }

  2. Validação em lote

    {
      "batch": {
        "size": 100,
        "concurrent": true
      }
    }

Melhores práticas​

1. Organização de regras​

  • Categorizar regras por função
  • Usar nomes claros
  • Manter regras simples

2. Controle de versão​

  • Incluir regras no controle de versão
  • Documentar alterações de regras
  • Manter documentação de regras

3. Colaboração da equipe​

  • Discutir regras com a equipe
  • Coletar feedback
  • Revisar e atualizar regularmente

Funcionalidades avançadas​

Validador personalizado​

Criar validador específico do projeto:

.cursor/rules/custom-validator.js
module.exports = {
  validate: (code, context) => {
    // Lógica de validação personalizada
    return {
      valid: true,
      messages: []
    };
  }
};

Correção automática​

Implementar correção automática:

module.exports = {
  fix: (code, issues) => {
    // Lógica de correção automática
    return fixedCode;
  }
};

Testes de integração​

Adicionar testes para regras:

rules.test.js
describe('Testes de regras MDC', () => {
  test('Convenção de nomenclatura', () => {
    // Lógica de teste de regras
  });
});

Ferramentas de depuração​

Diagnóstico de regras​

Ativar registro detalhado:

.cursor/settings.json
{
  "mdc.rules.debug": true,
  "mdc.rules.logLevel": "verbose"
}

Análise de desempenho​

Monitorar execução de regras:

# Analisar desempenho de regras
cursor analyze-rules

# Gerar relatório de desempenho
cursor rules-report

Cenários comuns​

1. Revisão de código​

Automatizar processo de revisão de código:

{
  "review": {
    "autoFix": true,
    "blockOnError": true,
    "notifyReviewer": true
  }
}

2. Integração CI/CD​

Usar regras na integração contínua:

.github/workflows/mdc.yml
steps:
  - name: Verificar regras MDC
    run: cursor check-rules

3. Integração IDE​

Configurar integração do editor:

.vscode/settings.json
{
  "cursor.rules.enableFormatting": true,
  "cursor.rules.showInlineHints": true
}

Recursos relacionados​