SuperAPI AI 工具集

memory-capture

办公与效率

查看项目

更新于 10-23 23:07

技能介绍

用途

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 供未来项目使用。

使用方式

  1. 前置检查:确认 .cocoplus/ 目录存在,否则提示“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
  2. 确认 Memory Engine 已开启:检查 .cocoplus/modes/memory.on 是否存在,若不存在则提示“Memory Engine is currently off. Run $memory on to enable cross-session memory capture.”并停止。
  3. 指定捕获内容:
    • 内联提供:$memory capture <text>
    • 无参数运行 $memory capture 进入交互模式,系统会询问要捕获的类型和内容。
  4. 根据类型追加到对应记忆文件。
  5. 输出确认:“Captured to .cocoplus/memory/<type>.md.”

适用场景

  • 记录关键选择及其理由(例如“选择星型模型而非 OBT 以提升查询性能”)。
  • 记录可复用的方法(例如“大事实表的增量加载模式”)。
  • 记录错误及其解决过程(例如“查询中途仓库挂起——重试前先使用 RESUME”)。

限制

  • 必须指定类型(decision/pattern/error),否则无法正确路由到对应文件。
  • Decision 必须包含 Rationale 字段,否则未来会话无法理解决策原因。
  • 错误与决策应分开记录,不应将“出错的决策”写入 errors.md。
  • 需要 .cocoplus/ 目录存在且 Memory Engine 已开启,否则无法执行。
  • 退出标准:条目已按格式追加到正确的记忆文件,包含日期前缀标题,并输出确认信息。