Memories é o sistema para compartilhar e manter contexto entre conversas.
Há dois mecanismos para isso no Cascade: Memories, que podem ser geradas automaticamente pelo Cascade, e regras, que são definidas manualmente pelo usuário nos níveis local e global.
Memories e Rules podem ser acessadas e configuradas a qualquer momento clicando no ícone Customizations no menu deslizante no canto superior direito do Cascade. Para editar uma Memory existente, basta clicar nela e depois clicar no botão Edit.
Durante a conversa, o Cascade pode gerar e armazenar memórias automaticamente quando encontrar um contexto que considere útil lembrar.
Além disso, você pode pedir ao Cascade para criar uma memória a qualquer momento. Basta solicitar ao Cascade: “crie uma memória de …”.
As memórias geradas automaticamente pelo Cascade estão associadas ao workspace em que foram criadas, e o Cascade as recuperará quando considerar que são relevantes. As memórias geradas em um workspace não ficam disponíveis em outro.
Criar e usar memórias geradas automaticamente NÃO consome créditos
global_rules.md - regras aplicadas a todos os workspaces
.windsurf/rules - diretório no nível do workspace que contém regras associadas a globs ou descrições em linguagem natural.
O Windsurf descobre automaticamente regras em vários locais para oferecer uma organização flexível:
- Workspace atual e subdiretórios: Todos os diretórios
.windsurf/rules dentro do seu workspace atual e de seus subdiretórios
- Estrutura do repositório Git: Em repositórios Git, o Windsurf também pesquisa até o diretório raiz do Git para encontrar regras em diretórios pai
- Suporte a múltiplos workspaces: Quando várias pastas estão abertas no mesmo workspace, as regras são deduplicadas e exibidas com o caminho relativo mais curto
Locais de armazenamento de regras
.windsurf/rules no diretório do seu workspace atual.windsurf/rules em qualquer subdiretório do seu workspace.windsurf/rules em diretórios pai até a raiz do Git (para repositórios Git)
Ao criar uma nova regra, ela será salva no diretório .windsurf/rules do seu workspace atual, não necessariamente na raiz do Git.
Para começar a usar Rules, clique no ícone Customizations no menu deslizante no canto superior direito do Cascade e vá até o painel Rules. Lá, você pode clicar no botão + Global ou + Workspace para criar novas regras nos níveis global ou de workspace, respectivamente.
Os arquivos de regras são limitados a 12.000 caracteres cada.
Para ajudar o Cascade a seguir suas regras com eficácia, siga estas melhores práticas:
- Mantenha as regras simples, concisas e específicas. Regras muito longas ou vagas podem confundir o Cascade.
- Não é necessário adicionar regras genéricas (por exemplo, “escreva um bom código”), pois isso já faz parte dos dados de treinamento do Cascade.
- Formate suas regras usando marcadores, listas numeradas e Markdown. Isso é mais fácil para o Cascade seguir do que um parágrafo longo.
Por exemplo:
# Diretrizes de Codificação
- A linguagem de programação do meu projeto é Python
- Use retornos antecipados quando possível
- Sempre adicione documentação ao criar novas funções e classes
- As tags XML podem ser uma forma eficaz de comunicar e agrupar regras semelhantes. Por exemplo:
<coding_guidelines>
- A linguagem de programação do meu projeto é Python
- Use retornos antecipados quando possível
- Sempre adicione documentação ao criar novas funções e classes
</coding_guidelines>
