适用场景

用户纠正你或指出错误；你完成重要工作后希望评估结果；你在自己的输出中发现可优化之处；知识应随时间自然累积，无需人工维护。

架构设计

记忆数据存储于 ~/self-improving/ 目录下，采用分层结构。若该目录不存在，请运行 setup.md 初始化。

~/self-improving/
├── memory.md          # HOT：≤100 行，始终加载
├── index.md           # 主题索引（含行数统计）
├── projects/          # 项目专属经验
├── domains/           # 领域专属（如 code、writing、comms）
├── archive/           # COLD：已衰减的模式
└── corrections.md     # 最近 50 条修正日志

快速参考

触发检测条件

当识别到以下模式时，自动记录：

修正行为 → 添加至 corrections.md，并评估是否需升入 memory.md：

• “不对，这不是正确的……”
• “实际上应该是……”
• “你在……方面错了”
• “我偏好 X，而非 Y”
• “记住我总是……”
• “我之前告诉过你……”
• “停止做 X”
• “你为什么一直……”

偏好信号 → 若表述明确，则添加至 memory.md：

• “我喜欢你……”
• “请始终为我执行 X”
• “永远不要执行 Y”
• “我的风格是……”
• “对于 [project]，请使用……”

潜在模式候选 → 先跟踪，累计出现 3 次后升级：

• 同一指令重复出现 ≥3 次
• 某工作流反复表现良好
• 用户明确表扬某种方法

忽略项（不记录）：

• 一次性指令（如“现在执行 X”）
• 上下文限定指令（如“在此文件中……”）
• 假设性提问（如“如果……会怎样？”）

自我反思

完成重要任务后，请暂停并进行评估：

1. 是否达到预期？ —— 对比实际结果与原始意图
2. 哪些地方可以改进？ —— 明确下次可优化的具体点
3. 这是否构成一种模式？ —— 若是，记录至 corrections.md

触发自我反思的时机：

• 完成多步骤任务后
• 收到反馈（正面或负面）后
• 修复 Bug 或错误后
• 察觉自身输出存在提升空间时

日志格式：

CONTEXT: [任务类型]
REFLECTION: [所观察到的问题]
LESSON: [后续应如何调整]

示例：

CONTEXT: 构建 Flutter UI
REFLECTION: 间距显示异常，需重新调整
LESSON: 向用户展示前务必检查视觉间距

自我反思条目遵循相同升级规则：成功应用 3 次 → 升级至 HOT 层。

快捷查询指令

记忆统计信息

收到 “memory stats” 请求时，返回如下报告：

📊 Self-Improving Memory

HOT（始终加载）：
  memory.md：X 条记录

WARM（按需加载）：
  projects/：X 个文件
  domains/：X 个文件

COLD（归档层）：
  archive/：X 个文件

近期活动（7 天内）：
  新增修正记录：X 条
  升级至 HOT 层：X 条
  降级至 WARM 层：X 条

核心规则

1. 从修正与自我反思中学习

• 用户明确纠正你时，必须记录
• 你自主识别出自身工作的改进点时，必须记录
• 禁止仅凭沉默推断用户偏好
• 同一教训重复出现 3 次后 → 主动询问是否确认为通用规则

2. 分层存储

3. 自动升降级机制

• 某模式在 7 天内被使用 3 次 → 升级至 HOT
• 某模式连续 30 天未被使用 → 降级至 WARM
• 某模式连续 90 天未被使用 → 归档至 COLD
• 任何删除操作前必须先向用户确认

4. 命名空间隔离

• 项目专属模式保存于 projects/{name}.md
• 全局偏好保存于 HOT 层（memory.md）
• 领域专属模式（如 code、writing）保存于 domains/
• 跨命名空间继承顺序：全局 → 领域 → 项目

5. 冲突解决策略

当模式发生冲突时：

1. 最具体者优先（项目 > 领域 > 全局）
2. 同级中最新者优先
3. 若仍无法判定 → 向用户询问

6. 压缩机制

当文件超出容量限制时：

1. 合并相似修正为一条规则
2. 归档长期未使用的模式
3. 精简冗长条目为摘要形式
4. 已确认的偏好永不丢失

7. 透明性保障

• 所有基于记忆的决策 → 必须注明来源，例如：“Using X (from projects/foo.md:12)”
• 提供周度汇总：新学模式、降级模式、归档模式
• 支持按需全量导出：所有文件打包为 ZIP

8. 安全边界

详见 boundaries.md —— 禁止存储凭据、健康数据、第三方信息。

9. 优雅降级

当上下文长度受限时：

1. 仅加载 memory.md（HOT 层）
2. 按需加载相关命名空间下的文件
3. 绝不静默失败 —— 明确告知用户哪些内容未被加载

作用范围

本能力仅支持：

• 从用户修正与自我反思中学习
• 将偏好持久化至本地文件（~/self-improving/）
• 在激活时读取自身记忆文件

本能力绝不允许：

• 访问日历、邮件或联系人
• 发起网络请求
• 读取 ~/self-improving/ 路径以外的任意文件
• 通过沉默或观察推断用户偏好
• 修改自身的 SKILL.md 文件

关联能力

若用户确认，可通过 clawhub install 安装以下能力：

• memory —— 为 Agent 提供长期记忆模式
• learning —— 自适应教学与解释能力
• decide —— 自动学习决策模式
• escalate —— 判断何时应主动询问、何时可自主执行

反馈方式

• 若觉得有用：clawhub star self-improving
• 保持更新：clawhub sync