self-improving-agent

Self-Improving Agent

自动记忆负责捕获，本插件负责整理。

Claude Code 的自动记忆（v2.1.32+）会自动将项目模式、调试洞察和你的偏好记录到 MEMORY.md 中。本插件则补上智能层：它分析 Claude 学到的内容，将经过验证的模式提升为项目规则，并把反复出现的解决方案提炼为可复用的技能。

快速参考

命令	作用
/si:memory-review	分析 MEMORY.md，找出可提升的候选条目、过时条目和可合并的机会
/si:promote	将 MEMORY.md 中的模式毕业为 CLAUDE.md 或 .claude/rules/ 中的规则
/si:extract	将经过验证的模式转化为独立技能
/si:memory-status	记忆健康仪表盘，包括行数、主题文件和建议
/si:remember	显式将重要知识保存到自动记忆中

整体协作方式

┌─────────────────────────────────────────────────────────┐
│                  Claude Code Memory Stack                │
├─────────────┬──────────────────┬────────────────────────┤
│  CLAUDE.md  │   Auto Memory    │   Session Memory       │
│  (you write)│   (Claude writes)│   (Claude writes)      │
│  Rules &    │   MEMORY.md      │   Conversation logs    │
│  standards  │   + topic files  │   + continuity         │
│  Full load  │   First 200 lines│   Contextual load      │
├─────────────┴──────────────────┴────────────────────────┤
│              ↑ /si:promote        ↑ /si:memory-review   │
│         Self-Improving Agent (this plugin)               │
│              ↓ /si:extract    ↓ /si:remember            │
├─────────────────────────────────────────────────────────┤
│  .claude/rules/    │    New Skills    │   Error Logs     │
│  (scoped rules)    │    (extracted)   │   (auto-captured)│
└─────────────────────────────────────────────────────────┘

安装

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.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）	范围限定规则	匹配的文件打开时加载

提升生命周期

1. Claude discovers pattern → auto-memory (MEMORY.md)
2. Pattern recurs 2-3x → /si:memory-review flags it as promotion candidate
3. You approve → /si:promote graduates it to CLAUDE.md or rules/
4. Pattern becomes an enforced rule, not just a note
5. MEMORY.md entry removed → frees space for new learnings

核心概念

自动记忆负责捕获，而非整理

自动记忆非常擅长记录 Claude 学到的内容。但它在以下方面缺乏判断力：

• 哪些学习内容是临时的，哪些是永久的
• 哪些模式应该成为强制执行的规则
• 200 行的上限何时被过时条目浪费
• 哪些解决方案足够好，可以成为可复用的技能

这正是本插件所做的事情。

提升即毕业

当你提升一条学习内容时，它会从 Claude 的草稿本（MEMORY.md）转移到你项目的规则体系（CLAUDE.md 或 .claude/rules/）中。两者的区别很重要：

• MEMORY.md："我注意到这个项目使用 pnpm"（背景上下文）
• CLAUDE.md："使用 pnpm，而不是 npm"（强制指令）

提升后的规则优先级更高，并且会完整加载（不会在 200 行处被截断）。

用于范围知识的规则目录

并非所有内容都应放在 CLAUDE.md 中。对于仅适用于特定文件类型的模式，请使用 .claude/rules/：

# .claude/rules/api-testing.md
---
paths:
  - "src/api/**/*.test.ts"
  - "tests/api/**/*"
---
- Use supertest for API endpoint testing
- Mock external services with msw
- Always test error responses, not just happy paths

这样，只有当 Claude 处理 API 测试文件时才会加载该规则，其他情况下零开销。

Agents

memory-analyst

分析 MEMORY.md 和主题文件，以识别：

• 跨会话反复出现的条目（提升候选）
• 引用已删除文件或旧模式的过时条目
• 应当合并的相关条目
• MEMORY.md 所知内容与 CLAUDE.md 所强制执行内容之间的差距

skill-extractor

接收经过验证的模式，并生成完整的技能：

• 带有正确 frontmatter 的 SKILL.md
• 参考文档
• 示例和边界情况
• 可用于 /plugin install 或 clawhub publish

Hooks

error-capture（PostToolUse → Bash）

监控命令输出中的错误。检测到错误时，会向自动记忆追加一条结构化条目，包含：

• 失败的命令
• 错误输出（已截断）
• 时间戳和上下文
• 建议的分类

Token 开销： 成功时为零；仅在检测到错误时约 30 个 token。

平台支持

平台	记忆系统	插件是否可用？
Claude Code	自动记忆（MEMORY.md）	✅ 完整支持
OpenClaw	workspace/MEMORY.md	✅ 已适配（读取 workspace 记忆）
Codex CLI	AGENTS.md	✅ 已适配（读取 AGENTS.md 模式）
GitHub Copilot	.github/copilot-instructions.md	⚠️ 仅支持手动提升

相关链接

• Claude Code Memory 文档
• pskoett/self-improving-agent — 灵感来源
• playwright-pro — 本仓库中的同系列插件