SamuelChien/mega-skills-collection

Agent Memory Skill

Este skill proporciona un banco de memoria persistente y buscable que se sincroniza automáticamente con la documentación del proyecto. Se ejecuta como un servidor MCP para permitir la lectura, escritura y búsqueda de recuerdos a largo plazo.

Prerrequisitos

• Node.js (v18+)

Configuración

1. Clonar el repositorio: Clona el proyecto agentMemory en el espacio de trabajo de tu agente o en un directorio paralelo:

   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
   

2. Instalar dependencias:

   cd .agent/skills/agent-memory
   npm install
   npm run compile
   

3. Iniciar el servidor MCP: Usa el script auxiliar para activar el banco de memoria para tu proyecto actual:

   npm run start-server <project_id> <ruta_absoluta_al_espacio_de_trabajo_destino>
   

   Ejemplo para el directorio actual:

   npm run start-server my-project $(pwd)
   

Capacidades (Herramientas MCP)

memory_search

Busca recuerdos por consulta, tipo o etiquetas.

• Args: query (string), type? (string), tags? (string[])
• Uso: "Encuentra todos los patrones de autenticación" -> memory_search({ query: "authentication", type: "pattern" })

memory_write

Registra nuevo conocimiento o decisiones.

• Args: key (string), type (string), content (string), tags? (string[])
• Uso: "Guarda esta decisión de arquitectura" -> memory_write({ key: "auth-v1", type: "decision", content: "..." })

memory_read

Recupera contenido de memoria específico por clave.

• Args: key (string)
• Uso: "Obtén el diseño de autenticación" -> memory_read({ key: "auth-v1" })

memory_stats

Visualiza estadísticas sobre el uso de la memoria.

• Uso: "Muestra estadísticas de memoria" -> memory_stats({})

Panel de control

Este skill incluye un panel de control independiente para visualizar el uso de la memoria.

npm run start-dashboard <ruta_absoluta_al_espacio_de_trabajo_destino>

Accede en: http://localhost:3333

Cuándo usar

Este skill es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la visión general.

Limitaciones

• Usa este skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
• No trates la salida como un sustituto de la validación específica del entorno, pruebas o revisión por expertos.
• Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.