AgentSkillsCN

memory-skill

管理对话记忆。当用户希望记住某件事、回忆相关信息、查看/编辑对话历史,或管理短期/长期记忆时,可使用此技能。

SKILL.md
--- frontmatter
name: memory-skill
description: Manage conversation memory. Use when user asks to remember something, recall information, view/edit conversation history, or manage short/long-term memory.
allowed-tools: memory-save memory-get memory-clear memory-view memory-search
metadata:
  author: machina
  version: "2.0"
  category: memory
  icon: "🧠"
  color: "#8B5CF6"

Memory Management Skill

This skill enables you to manage conversation memory using the SimpleMemory node's markdown-based storage system.

Memory Architecture

Short-Term Memory (Markdown)

  • Visible and editable in the SimpleMemory node's UI
  • Stored as markdown with timestamped entries
  • Window-based: keeps last N message pairs (configurable)
  • Format: ### **Human** (timestamp) and ### **Assistant** (timestamp)

Long-Term Memory (Vector DB)

  • Automatically archives messages that exceed the window
  • Semantic search for relevant past conversations
  • Enabled via longTermEnabled in SimpleMemory node

Capabilities

  1. View History: See recent conversation in markdown format
  2. Save Notes: Add explicit notes/memories to the conversation
  3. Search Memory: Find relevant past conversations semantically
  4. Clear Memory: Reset conversation history

When to Use

Save information when:

  • User says "remember this" or "don't forget"
  • Important context is shared for future use
  • User wants to note something specific

Recall information when:

  • User asks "do you remember..."
  • Context from earlier is needed
  • User references previous discussions

View history when:

  • User wants to see conversation log
  • Debugging or reviewing past exchanges

Tool Reference

memory-save

Add a note or memory entry to the conversation history.

Parameters:

  • content (required): Information to remember
  • role (optional): "note" (default) or "context"

Example:

json
{
  "content": "User's favorite color is blue",
  "role": "note"
}

memory-get

Get recent conversation history or search for specific content.

Parameters:

  • count (optional): Number of recent messages (default: 10)
  • search (optional): Search term to find specific memories

Example - Recent history:

json
{
  "count": 5
}

Example - Search:

json
{
  "search": "favorite color"
}

memory-clear

Clear conversation history.

Parameters:

  • confirm (required): Must be true to clear

Example:

json
{
  "confirm": true
}

memory-view

View the current conversation history in markdown format.

Parameters: None

Returns the full markdown content of the conversation history.

memory-search

Semantic search in long-term memory (if enabled).

Parameters:

  • query (required): Search query
  • count (optional): Number of results (default: 3)

Example:

json
{
  "query": "what did we discuss about the project",
  "count": 5
}

Markdown Format

The conversation history uses this format:

markdown
# Conversation History

### **Human** (2025-01-30 10:15:32)
Hello, how are you?

### **Assistant** (2025-01-30 10:15:35)
I'm doing well! How can I help you today?

### **Note** (2025-01-30 10:16:00)
User prefers formal language.

Integration with SimpleMemory Node

When connected to a Zeenie:

  1. Conversation is automatically logged to markdown
  2. Window size limits short-term memory
  3. Overflow archives to vector DB (if long-term enabled)
  4. You can view/edit the markdown in the node's parameter panel

Best Practices

  1. Use memory-save for explicit user requests to remember
  2. Use memory-search for semantic recall of past discussions
  3. Don't save sensitive information without user consent
  4. The markdown is editable - users can manually curate their history