何时使用

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

架构

记忆存储于 ~/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. 压缩（Compaction）

当文件超出容量限制时：

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 —— 为智能体提供长期记忆模式
• learning —— 自适应教学与解释能力
• decide —— 自动学习决策模式
• escalate —— 判断何时应主动询问、何时可自主行动

反馈

• 若本能力有用：clawhub star self-improving
• 保持更新：clawhub sync