memory-capture

记忆捕获技能

统一的记忆捕获技能，可路由到两种执行模式：

• 精简：将完整会话记忆压缩为结构化文本，以便恢复
• 提示：快速记录想法、代码片段和见解

架构概览

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

执行流程

步骤 1：解析输入并路由

根据用户输入检测执行模式：

自动路由规则（按优先级排序）：

信号	路由	示例
关键词：compact、session、压缩、recovery、保存会话	→ 精简	"compact current session"
关键词：tip、note、记录、快速	→ 提示	"记录一个想法"
包含 --tag 或 --context 标志	→ 提示	"note content" --tag bug
短文本（<100 个字符）且不含会话关键词	→ 提示	"记得使用 Redis"
模糊不清或没有参数	→ AskUserQuestion	/memory-capture

遇到模糊情况时，使用 AskUserQuestion：

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

步骤 2：执行所选阶段

根据路由结果，读取并执行相应阶段：

• 精简模式 → 参考：phases/01-compact.md
• 提示模式 → 参考：phases/02-tips.md

阶段参考文档（在阶段执行时按需读取）：

模式	文档	用途
精简	phases/01-compact.md	完整会话记忆压缩与结构化导出
提示	phases/02-tips.md	使用标签和上下文快速记录

步骤 3：通过 core_memory 保存

两个阶段最终都会使用相同的存储机制：

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

核心规则

1. 单阶段执行：每次调用只执行一个阶段，绝不同时执行两个阶段
2. 忠实于内容：阶段文件包含完整的执行细节，须逐字遵循
3. 绝对路径：输出中的所有文件路径都必须是绝对路径
4. 不做摘要：精简模式会逐字保留完整计划，绝不缩写
5. 优先考虑速度：提示模式应快速完成，尽量减少分析开销

输入处理

精简模式输入

• 可选："session description"，作为补充上下文
• 示例：/memory-capture compact 或 /memory-capture "completed auth module"

提示模式输入

• 必填：<note content>——提示/笔记文本
• 可选：--tag <tag1,tag2>，用于分类
• 可选：--context <context>，用于引用相关代码/功能
• 示例：/memory-capture tip "Use Redis for rate limiting" --tag config

数据流

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

错误处理

错误	操作
core_memory 导入失败	重试一次，然后报告错误并提供结构化文本供手动保存
没有会话上下文（精简）	警告用户，并根据现有信息生成
笔记内容为空（提示）	通过 AskUserQuestion 请用户提供内容
路由模糊不清	默认使用 AskUserQuestion，绝不猜测