Pular para o conteúdo principal

Como Criar Novos Arquivos com o Cursor Agent

Introdução​

A criação de novos arquivos através da interação com o AI agent é um recurso frequentemente solicitado no Cursor. Embora a interface de chat em si não suporte a criação direta de arquivos, existem outras maneiras disponíveis.

Soluções Atuais​

1. Usando o Composer (Recomendado)​

O método recomendado para criar novos arquivos é usar o Composer (Ctrl + I). Este recurso permite:

  • Criar e editar múltiplos arquivos
  • Criar uma estrutura completa de arquivos
  • Aplicar alterações em vários arquivos simultaneamente

Exemplos de Cenários:​

  1. Criar uma estrutura completa de site HTML:

    • index.html
    • css/styles.css
    • js/script.js

  2. Dividir um esquema OpenAPI em múltiplos arquivos

  3. Criar arquivos de componentes com seus respectivos arquivos de estilo e teste

2. Método Command+K​

Você pode usar Command+K (ou Ctrl+K) para criar um arquivo do zero, mas isso é limitado à criação de um único arquivo.

Cenários de Uso Comum​

1. Desenvolvimento de Componentes​

  • Criar novos componentes React com arquivos independentes
  • Criar arquivos de teste associados
  • Criar arquivos de estilo para componentes

2. Estrutura de Testes​

  • Criar arquivos de teste unitário para múltiplos componentes: 
    component1.ts → component1.test.ts
    component2.ts → component2.test.ts
    component3.ts → component3.test.ts

3. Internacionalização​

  • Criar arquivos JSON de tradução
  • Criar arquivos de recursos para idiomas específicos

4. Refatoração de Código​

  • Extrair funções para arquivos de utilidades
  • Dividir arquivos grandes em módulos
  • Criar novos arquivos de endpoint

Melhores Práticas​

  1. Use o Composer para operações multi-arquivo
  2. Forneça uma descrição clara da estrutura de arquivos desejada
  3. Inclua contexto sobre relações entre arquivos
  4. Especifique quaisquer convenções ou padrões de nomenclatura a serem seguidos

Dicas​

  • Ao usar o Composer, seja específico sobre a estrutura de pastas a ser criada
  • Inclua detalhes sobre dependências e relações entre arquivos
  • Para estruturas complexas, divida a criação em etapas menores
  • Revise os arquivos gerados antes de aplicar as alterações

Fonte​

@https://forum.cursor.com/t/agent-create-new-files/408