用途
memory-capture 用于将开发者指定的决策、可复用模式或错误解决方案手动捕获到 CocoPlus 的 Memory Engine,写入 .cocoplus/memory/ 目录,实现跨会话持久化。
主要能力
- 支持三种捕获类型:Decision(决策)、Pattern(模式)、Error(错误)。
- 每种类型写入对应的记忆文件:
- Decision → .cocoplus/memory/decisions.md
- Pattern → .cocoplus/memory/patterns.md
- Error → .cocoplus/memory/errors.md
- 每条记录按固定格式追加,包含日期时间标题(## [YYYY-MM-DD HH:MM] <标题>)及类型专属字段:
- Decision:Decision、Rationale、Alternatives Considered、Context(当前阶段来自 .cocoplus/AGENTS.md)。
- Pattern:Pattern、When to Apply、Example、Source。
- Error:Error、Root Cause、Resolution、Prevention。
- 捕获完成后输出确认信息,指明写入的文件。
- 若内容看起来是可复用模式,会建议运行 $patterns promote 将其添加到 CocoGrove 供未来项目使用。
使用方式
- 前置检查:确认 .cocoplus/ 目录存在,否则提示“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
- 确认 Memory Engine 已开启:检查 .cocoplus/modes/memory.on 是否存在,若不存在则提示“Memory Engine is currently off. Run $memory on to enable cross-session memory capture.”并停止。
- 指定捕获内容:
- 内联提供:$memory capture <text>
- 无参数运行 $memory capture 进入交互模式,系统会询问要捕获的类型和内容。
- 根据类型追加到对应记忆文件。
- 输出确认:“Captured to .cocoplus/memory/<type>.md.”
适用场景
- 记录关键选择及其理由(例如“选择星型模型而非 OBT 以提升查询性能”)。
- 记录可复用的方法(例如“大事实表的增量加载模式”)。
- 记录错误及其解决过程(例如“查询中途仓库挂起——重试前先使用 RESUME”)。
限制
- 必须指定类型(decision/pattern/error),否则无法正确路由到对应文件。
- Decision 必须包含 Rationale 字段,否则未来会话无法理解决策原因。
- 错误与决策应分开记录,不应将“出错的决策”写入 errors.md。
- 需要 .cocoplus/ 目录存在且 Memory Engine 已开启,否则无法执行。
- 退出标准:条目已按格式追加到正确的记忆文件,包含日期前缀标题,并输出确认信息。