SuperAPI AI 工具集

self-improving-agent

智能体与模型

查看项目

更新于 11-02 02:30

技能介绍

用途

self-improving-agent 是一个面向 Claude Code 的插件,定位在 Claude Code 自动记忆(auto-memory,v2.1.32+)之上提供“筛选和管理”能力。自动记忆负责记录项目模式、调试经验和用户偏好,但无法判断哪些经验是临时的、哪些应成为强制规则、哪些可复用为技能;该插件负责做这些判断。

记忆架构

资料中列出的记忆层次包括:

  • ./CLAUDE.md:由你(以及 /si:promote)写入,属于项目规则,每次会话完整加载。
  • ~/.claude/CLAUDE.md:由你写入,属于全局偏好,每次会话完整加载。
  • ~/.claude/projects/<path>/memory/MEMORY.md:由 Claude 自动写入,记录项目学习,只加载前 200 行。
  • ~/.claude/projects/<path>/memory/*.md:由 Claude 溢出写入,按主题记录,按需加载。
  • .claude/rules/*.md:由你(以及 /si:promote)写入,属于范围化规则,匹配文件打开时加载。

主要能力

插件提供以下命令:

  • /si:review:分析 MEMORY.md,找出提升候选、过时条目和可合并的机会。
  • /si:promote:把 MEMORY.md 中的模式提升到 CLAUDE.md 或 .claude/rules/。
  • /si:extract:把成熟模式转为独立技能。
  • /si:status:记忆健康看板,显示行数、主题文件和推荐项。
  • /si:remember:显式把重要知识保存到自动记忆。

插件还包含两个代理:

  • memory-analyst:分析 MEMORY.md 与主题文件,识别跨会话重复出现的条目(提升候选)、引用已删除文件或旧模式的过时条目、应合并的相关条目,以及 MEMORY.md 与 CLAUDE.md 之间的差距。
  • skill-extractor:根据成熟模式生成完整技能,包括带正确 frontmatter 的 SKILL.md、参考文档、示例和边界情况,并可发布到 /plugin install 或 clawhub。

此外还有 error-capture 钩子(PostToolUse → Bash),监控命令输出中的错误,检测到错误时向自动记忆追加结构化条目,包含失败命令、截断的错误输出、时间戳与上下文以及建议分类;成功时无 token 开销,检测到错误时约 30 tokens。

使用方式

资料给出的安装命令如下:

Claude Code 插件:

/plugin marketplace add alirezarezvani/claude-skills
/plugin install self-improving-agent@claude-code-skills

OpenClaw:

clawhub install self-improving-agent

Codex CLI:

./scripts/codex-install.sh --skill self-improving-agent

核心概念

  • 自动记忆是“捕获”,不是“筛选”:它记录 Claude 学到的东西,但不判断哪些是临时的、哪些应成为强制规则、200 行限制是否被过时条目占用、哪些方案值得成为可复用技能。
  • 提升即毕业:被提升的经验从 Claude 的草稿区(MEMORY.md)移动到项目规则系统(CLAUDE.md 或 .claude/rules/)。MEMORY.md 是背景上下文,CLAUDE.md 是强制指令;被提升的规则优先级更高且完整加载,不会被 200 行截断。
  • 规则目录用于范围化知识:.claude/rules/ 存放只适用于特定文件类型的模式,可通过 frontmatter 的 paths 指定匹配文件,仅在相关文件打开时加载,否则零开销。

提升生命周期

  1. Claude 发现模式,写入自动记忆(MEMORY.md)。
  2. 模式重复出现 2–3 次后,/si:review 将其标记为提升候选。
  3. 你批准后,/si:promote 将其提升到 CLAUDE.md 或 .claude/rules/。
  4. 该模式成为强制规则,而不再只是笔记。
  5. MEMORY.md 中的条目被移除,为新学习腾出空间。

平台支持

  • Claude Code:自动记忆(MEMORY.md),完整支持。
  • OpenClaw:workspace/MEMORY.md,已适配(读取工作区记忆)。
  • Codex CLI:AGENTS.md,已适配(读取 AGENTS.md 模式)。
  • GitHub Copilot:.github/copilot-instructions.md,仅支持手动提升。

限制

资料未提供收费、价格或效果方面的信息;对 GitHub Copilot 仅支持手动提升;其他限制暂未提供。