O que Habilidade de Memória do Agente faz?
Esta habilidade fornece um banco de memória persistente e pesquisável que sincroniza automaticamente com a documentação do projeto. Ela é executada como um servidor MCP para permitir leitura, escrita e pesquisa de memórias de longo prazo.
Pré-requisitos
- Node.js (v18+)
Configuração
-
Clone o Repositório: Clone o projeto
agentMemoryno workspace do seu agente ou em um diretório paralelo:git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory -
Instale as Dependências:
cd .agent/skills/agent-memory npm install npm run compile -
Inicie o Servidor MCP: Use o script auxiliar para ativar o banco de memória para o seu projeto atual:
npm run start-server <project_id> <absolute_path_to_target_workspace>Exemplo para o diretório atual:
npm run start-server my-project $(pwd)
Capacidades (Ferramentas MCP)
memory_search
Pesquise memórias por consulta, tipo ou tags.
- Args:
query(string),type?(string),tags?(string[]) - Uso: "Encontre todos os padrões de autenticação" ->
memory_search({ query: "authentication", type: "pattern" })
memory_write
Registre novos conhecimentos ou decisões.
- Args:
key(string),type(string),content(string),tags?(string[]) - Uso: "Salve esta decisão de arquitetura" ->
memory_write({ key: "auth-v1", type: "decision", content: "..." })
memory_read
Recupere o conteúdo específico de uma memória pela chave.
- Args:
key(string) - Uso: "Obtenha o design de autenticação" ->
memory_read({ key: "auth-v1" })
memory_stats
Visualize análises sobre o uso da memória.
- Uso: "Mostre as estatísticas de memória" ->
memory_stats({})
Painel
Esta habilidade inclui um painel independente para visualizar o uso da memória.
npm run start-dashboard <absolute_path_to_target_workspace>
Acesse em: http://localhost:3333
Quando Usar
Esta habilidade é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como um substituto para validação, testes ou revisão especializada específica do ambiente.
- Pare e peça esclarecimentos se entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.