用途
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指定匹配文件,仅在相关文件打开时加载,否则零开销。
提升生命周期
- Claude 发现模式,写入自动记忆(MEMORY.md)。
- 模式重复出现 2–3 次后,
/si:review将其标记为提升候选。 - 你批准后,
/si:promote将其提升到 CLAUDE.md 或.claude/rules/。 - 该模式成为强制规则,而不再只是笔记。
- MEMORY.md 中的条目被移除,为新学习腾出空间。
平台支持
- Claude Code:自动记忆(MEMORY.md),完整支持。
- OpenClaw:workspace/MEMORY.md,已适配(读取工作区记忆)。
- Codex CLI:AGENTS.md,已适配(读取 AGENTS.md 模式)。
- GitHub Copilot:
.github/copilot-instructions.md,仅支持手动提升。
限制
资料未提供收费、价格或效果方面的信息;对 GitHub Copilot 仅支持手动提升;其他限制暂未提供。