memory-capture

Memory Capture Skill

Unified memory capture skill that routes to two execution modes:

• Compact: Compress full session memory into structured text for recovery
• Tips: Quick note-taking for ideas, snippets, and insights

Architecture Overview

┌─────────────────────────────────────────────────────┐
│  Memory Capture (Router)                            │
│  → Parse input → Detect mode → Route to phase       │
└───────────────┬─────────────────────────────────────┘
                │
        ┌───────┴───────┐
        ↓               ↓
  ┌───────────┐   ┌───────────┐
  │  Compact  │   │   Tips    │
  │  (Phase1) │   │  (Phase2) │
  │  Full     │   │  Quick    │
  │  Session  │   │  Note     │
  └─────┬─────┘   └─────┬─────┘
        │               │
        └───────┬───────┘
                ↓
        ┌───────────────┐
        │  core_memory  │
        │   (import)    │
        └───────────────┘

Execution Flow

Step 1: Parse Input & Route

Detect execution mode from user input:

Auto-Route Rules (priority order):

Signal	Route	Examples
Keyword: compact, session, 压缩, recovery, 保存会话	→ Compact	"compact current session"
Keyword: tip, note, 记录, 快速	→ Tips	"记录一个想法"
Has --tag or --context flags	→ Tips	"note content" --tag bug
Short text (<100 chars) + no session keywords	→ Tips	"Remember to use Redis"
Ambiguous or no arguments	→ AskUserQuestion	/memory-capture

When ambiguous, use AskUserQuestion:

Question: "选择记忆捕获模式"
Options:
  1. Compact - 压缩当前完整会话记忆（用于会话恢复）
  2. Tips - 快速记录一条笔记/想法/提示

Step 2: Execute Selected Phase

Based on routing result, read and execute the corresponding phase:

• Compact mode → Ref: phases/01-compact.md
• Tips mode → Ref: phases/02-tips.md

Phase Reference Documents (read on-demand when phase executes):

Mode	Document	Purpose
Compact	phases/01-compact.md	Full session memory compression and structured export
Tips	phases/02-tips.md	Quick note-taking with tags and context

Step 3: Save via core_memory

Both phases converge on the same storage mechanism:

mcp__ccw-tools__core_memory({
  operation: "import",
  text: structuredText  // Generated by the selected phase
})

Core Rules

1. Single Phase Execution: Only ONE phase executes per invocation - never both
2. Content Faithful: Phase files contain full execution detail - follow them verbatim
3. Absolute Paths: All file paths in output must be absolute
4. No Summarization: Compact mode preserves complete plan verbatim - never abbreviate
5. Speed Priority: Tips mode should be fast - minimal analysis overhead

Input Processing

Compact Mode Input

• Optional: "session description" as supplementary context
• Example: /memory-capture compact or /memory-capture "completed auth module"

Tips Mode Input

• Required: <note content> - the tip/note text
• Optional: --tag <tag1,tag2> for categorization
• Optional: --context <context> for related code/feature reference
• Example: /memory-capture tip "Use Redis for rate limiting" --tag config

Data Flow

User Input
    │
    ├─ [compact detected] → Read phases/01-compact.md
    │                        → Analyze session → Generate structured text
    │                        → core_memory import → Report Recovery ID
    │
    └─ [tips detected] → Read phases/02-tips.md
                         → Parse args → Gather context → Generate tip text
                         → core_memory import → Confirm with ID + tags

Error Handling

Error	Action
core_memory import fails	Retry once, then report error with structured text for manual save
No session context (compact)	Warn user, generate with available info
Empty note content (tips)	Ask user to provide content via AskUserQuestion
Ambiguous routing	Default to AskUserQuestion - never guess