AgentSkillsCN

episodic-archiver

情景记忆归档器。将完整的对话记录连同嵌入向量与分析结果一并存储于 ArangoDB 中。可用于保存“用户故事”或“思维链”。

SKILL.md
--- frontmatter
name: episodic-archiver
description: >
  Episodic Memory Archiver. Stores full conversation transcripts with embeddings
  and analysis into ArangoDB. Use this to save the "User Story" or "Chain of Thought".
allowed-tools: Bash
triggers:
  - archive conversation
  - save episode
  - store transcript
  - remember this conversation
metadata:
  short-description: Analyzes and stores episodic conversation memory

Episodic Archiver

This skill analyzes full conversation transcripts, embeds them for search, and categorizes turns.

Usage

bash
# Save a JSON transcript to episodic memory
.agents/skills/episodic-archiver/run.sh archive <transcript.json>

Input Format

The JSON file should be a list of messages or an object with a messages list:

json
{
  "session_id": "task_123",
  "messages": [
    {
      "from": "Coordinator",
      "to": "Worker",
      "message": "Please fix the bug...",
      "timestamp": 1234567890
    },
    ...
  ]
}

Storage

Data is stored in ArangoDB collection agent_conversations with:

  • embedding: Vector representation (768d)
  • category: LLM-derived tag (Task, Question, Solution, etc.)

Prerequisites

  • ArangoDB credentials in .env (e.g., ARANGO_URL, ARANGO_DB, ARANGO_USER, ARANGO_PASS).
  • Local embedding model availability (graph_memory’s embedding stack).
  • Optional but recommended: CHUTES_API_KEY or OPENAI_API_KEY (for categorization).