memory-on

用途

memory-on 是 CocoPlus（snowflake-labs/cocoplus）提供的一个技能，目标是在当前项目中启用 Memory Engine（记忆引擎）。启用后，CocoPlus 会在工具使用过程中自动捕获决策与模式，并把这些记录持久化，使其在后续会话中仍然可用。

主要能力

• 前置检查：执行前验证当前目录下是否存在 .cocoplus/ 目录。若不存在，则输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止执行。
• 创建模式标记：通过 Write 工具创建空内容的 .cocoplus/modes/memory.on 文件（跨平台，不使用 touch 命令）。
• 初始化记忆文件：若下列文件不存在则创建，并写入对应标题：
  • .cocoplus/memory/decisions.md，标题为 # Decisions Log 并附说明“Decisions captured by CocoPlus Memory Engine”
  • .cocoplus/memory/patterns.md，标题为 # Patterns Log 并附说明“Patterns identified by CocoPlus Memory Engine”
  • .cocoplus/memory/errors.md，标题为 # Errors Log 并附说明“Error lessons captured by CocoPlus Memory Engine”
• 更新 AGENTS.md：保持文件不超过 200 行，将 Memory 行替换为 - Memory: ON (capturing decisions)。
• 输出结果：启用成功后输出确认信息，并报告现有记忆数量，例如“✓ Memory Engine enabled. Decisions, patterns, and error lessons will be captured automatically and persisted across sessions. Existing memory: [decision count] decisions, [pattern count] patterns.”

使用方式

该技能以指令形式给出，执行流程如下：

1. 检查 .cocoplus/ 是否存在，不存在则提示运行 $pod init 并终止。
2. 使用 Write 工具创建 .cocoplus/modes/memory.on 空文件。
3. 按需初始化 decisions.md、patterns.md、errors.md，写入规定的标题。
4. 更新 .cocoplus/AGENTS.md 的 Memory 行。
5. 输出启用成功信息及现有决策、模式计数。

资料中特别提示了两类应避免的做法：一是不要直接覆盖已存在的记忆文件，否则会破坏跨会话的历史记录；二是不要因为标记文件已创建就跳过更新 AGENTS.md，因为过时的“Memory: off”会导致会话启动时不加载记忆上下文。

完成标准

• .cocoplus/modes/memory.on 标记文件存在。
• decisions.md、patterns.md、errors.md 三个文件均存在且标题正确。
• .cocoplus/AGENTS.md 的 Memory 行显示为 - Memory: ON (capturing decisions)。
• 输出中包含现有决策与模式的数量报告。

适用场景

适用于已在当前目录初始化 CocoPlus、希望让智能体在跨会话中记住项目决策、代码模式和错误教训的使用者。

限制

必须在已初始化 CocoPlus（存在 .cocoplus/）的目录中使用，否则会被直接终止；资料未提供该技能的收费情况、支持平台或版本要求等信息。