用途
该技能用于让智能体具备主动自我反思与持续改进能力。当用户纠正智能体、指出错误,或智能体完成重要工作后需要评估结果、发现自身输出可改进之处时,可启用该技能。其目标是让知识随时间累积,无需手动维护。
主要能力
- 自我反思:完成多步任务、收到反馈、修复错误或发现输出可改进后,暂停并评估:是否达到预期、哪里可以更好、是否构成模式。
- 自我批评与纠正记录:自动识别纠正类触发语(如“不,那不对……”“实际上应该是……”“你错了……”“我更喜欢 X,不是 Y”“记住我总是……”“我以前告诉过你……”“别再做 X”“你为什么总是……”),记录到 corrections.md,并评估是否进入 memory.md。
- 偏好信号记录:识别显式偏好(如“我喜欢你……”“总是为我做 X”“永远不要做 Y”“我的风格是……”“对于[项目],使用……”),若明确则加入 memory.md。
- 模式候选跟踪:同一指令重复 3 次以上、反复有效的工作流、用户称赞的特定方法,会被跟踪并在 3 次后晋升。
- 分层记忆存储:
- HOT:memory.md,≤100 行,始终加载。
- WARM:projects/、domains/,每个 ≤200 行,上下文匹配时加载。
- COLD:archive/,无限制,显式查询时加载。
- 自动晋升/降级:7 天内使用 3 次 → 晋升至 HOT;30 天未使用 → 降级至 WARM;90 天未使用 → 归档至 COLD;未经询问不删除。
- 命名空间隔离:项目模式存于 projects/{name}.md,全局偏好存于 HOT 层,领域模式(代码、写作)存于 domains/;跨命名空间继承顺序为全局 → 领域 → 项目。
- 冲突解决:模式矛盾时,更具体者优先(项目 > 领域 > 全局),同层级更近者优先,模糊时询问用户。
- 压缩:文件超限时合并相似纠正为单条规则、归档未使用模式、摘要冗长条目,且不丢失已确认偏好。
- 透明性:每次从记忆执行操作时引用来源(如“Using X (from projects/foo.md:12)”);提供每周摘要;支持按需导出全部文件为 ZIP。
- 优雅降级:上下文超限时仅加载 memory.md(HOT),按需加载相关命名空间,并明确告知用户哪些未加载。
使用方式
记忆位于 ~/self-improving/,采用分层结构:
~/self-improving/
├── memory.md # HOT: ≤100 lines, always loaded
├── index.md # Topic index with line counts
├── projects/ # Per-project learnings
├── domains/ # Domain-specific (code, writing, comms)
├── archive/ # COLD: decayed patterns
└── corrections.md # Last 50 corrections log
若 ~/self-improving/ 不存在,运行 setup.md。
快速参考:
| 主题 | 文件 |
|---|---|
| 设置指南 | setup.md |
| 记忆模板 | memory-template.md |
| 学习机制 | learning.md |
| 安全边界 | boundaries.md |
| 扩展规则 | scaling.md |
| 记忆操作 | operations.md |
| 自我反思日志 | reflections.md |
自我反思日志格式:
CONTEXT: [type of task]
REFLECTION: [what I noticed]
LESSON: [what to do differently]
示例:
CONTEXT: Building Flutter UI
REFLECTION: Spacing looked off, had to redo
LESSON: Check visual spacing before showing user
自我反思条目遵循相同晋升规则:成功应用 3 次 → 晋升至 HOT。
快速查询:
| 用户说 | 动作 |
|---|---|
| “What do you know about X?” | 在所有层级搜索 X |
| “What have you learned?” | 显示 corrections.md 最近 10 条 |
| “Show my patterns” | 列出 memory.md(HOT) |
| “Show [project] patterns” | 加载 projects/{name}.md |
| “What's in warm storage?” | 列出 projects/ + domains/ 文件 |
| “Memory stats” | 显示各层级计数 |
| “Forget X” | 从所有层级移除(先确认) |
| “Export memory” | 打包所有文件为 ZIP |
记忆统计报告格式:
📊 Self-Improving Memory
HOT (always loaded):
memory.md: X entries
WARM (load on demand):
projects/: X files
domains/: X files
COLD (archived):
archive/: X files
Recent activity (7 days):
Corrections logged: X
Promotions to HOT: X
Demotions to WARM: X
核心规则
- 从纠正与自我反思中学习:用户明确纠正时记录;自己发现改进时记录;绝不从沉默中推断;3 条相同教训后询问是否确认为规则。
- 分层存储:HOT(memory.md,≤100 行,始终加载)、WARM(projects/、domains/,每个 ≤200 行,上下文匹配时加载)、COLD(archive/,无限制,显式查询时加载)。
- 自动晋升/降级:7 天内使用 3 次 → 晋升至 HOT;30 天未使用 → 降级至 WARM;90 天未使用 → 归档至 COLD;未经询问不删除。
- 命名空间隔离:项目模式留在 projects/{name}.md;全局偏好在 HOT 层;领域模式在 domains/;跨命名空间继承:全局 → 领域 → 项目。
- 冲突解决:更具体者优先(项目 > 领域 > 全局);同层级更近者优先;模糊时询问用户。
- 压缩:文件超限时合并相似纠正为单条规则、归档未使用模式、摘要冗长条目;绝不丢失已确认偏好。
- 透明性:每次从记忆执行操作时引用来源;提供每周摘要;支持按需导出全部文件为 ZIP。
- 安全边界:见 boundaries.md——绝不存储凭证、健康数据、第三方信息。
- 优雅降级:上下文超限时仅加载 memory.md(HOT),按需加载相关命名空间,绝不静默失败,告知用户哪些未加载。
适用场景
- 用户纠正智能体或指出错误时。
- 智能体完成重要工作并希望评估结果时。
- 智能体注意到自身输出可改进时。
- 希望知识随时间累积而无需手动维护时。
限制
该技能仅:从用户纠正和自我反思中学习;将偏好存储在本地文件(~/self-improving/);激活时读取自身记忆文件。
该技能绝不:访问日历、邮件或联系人;发起网络请求;读取 ~/self-improving/ 之外的文件;从沉默或观察中推断偏好;修改自身 SKILL.md。
相关技能
若用户确认,可用 clawhub install <slug> 安装:
- memory — Long-term memory patterns for agents
- learning — Adaptive teaching and explanation
- decide — Auto-learn decision patterns
- escalate — Know when to ask vs act autonomously
反馈
若有用:clawhub star self-improving
保持更新:clawhub sync