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](phases/01-compact.md) - **Tips mode** → Ref: [phases/02-tips.md](phases/02-tips.md) **Phase Reference Documents** (read on-demand when phase executes): | Mode | Document | Purpose | |------|----------|---------| | Compact | [phases/01-compact.md](phases/01-compact.md) | Full session memory compression and structured export | | Tips | [phases/02-tips.md](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: ```javascript 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 |