SuperAPI AI 工具集

self-improving agent (proactive self-reflection)

智能体与模型

查看项目

更新于 11-02 21:19

技能介绍

用途

该技能用于让智能体具备主动自我反思与持续改进能力。当用户纠正智能体、指出错误,或智能体完成重要工作后需要评估结果、发现自身输出可改进之处时,可启用该技能。其目标是让知识随时间累积,无需手动维护。

主要能力

  • 自我反思:完成多步任务、收到反馈、修复错误或发现输出可改进后,暂停并评估:是否达到预期、哪里可以更好、是否构成模式。
  • 自我批评与纠正记录:自动识别纠正类触发语(如“不,那不对……”“实际上应该是……”“你错了……”“我更喜欢 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

核心规则

  1. 从纠正与自我反思中学习:用户明确纠正时记录;自己发现改进时记录;绝不从沉默中推断;3 条相同教训后询问是否确认为规则。
  2. 分层存储:HOT(memory.md,≤100 行,始终加载)、WARM(projects/、domains/,每个 ≤200 行,上下文匹配时加载)、COLD(archive/,无限制,显式查询时加载)。
  3. 自动晋升/降级:7 天内使用 3 次 → 晋升至 HOT;30 天未使用 → 降级至 WARM;90 天未使用 → 归档至 COLD;未经询问不删除。
  4. 命名空间隔离:项目模式留在 projects/{name}.md;全局偏好在 HOT 层;领域模式在 domains/;跨命名空间继承:全局 → 领域 → 项目。
  5. 冲突解决:更具体者优先(项目 > 领域 > 全局);同层级更近者优先;模糊时询问用户。
  6. 压缩:文件超限时合并相似纠正为单条规则、归档未使用模式、摘要冗长条目;绝不丢失已确认偏好。
  7. 透明性:每次从记忆执行操作时引用来源;提供每周摘要;支持按需导出全部文件为 ZIP。
  8. 安全边界:见 boundaries.md——绝不存储凭证、健康数据、第三方信息。
  9. 优雅降级:上下文超限时仅加载 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