Auto Improving Agent
/install auto-improving-agent
Self-Improving Agent
Capture what matters. Ignore noise. Promote proven patterns. Automate all of it.
Source of truth
.learnings/LEARNINGS.md— corrections, env configs, reusable fixes, architecture decisions.learnings/ERRORS.md— tool/command failures with fixes.learnings/FEATURE_REQUESTS.md— missing capabilities worth tracking.learnings/ARCHIVE.md— entries scored out during retention sweeps (never injected into context, but searchable)
Write gate
Before logging anything, the candidate must pass at least ONE filter:
| Filter | Weight | Description |
|---|---|---|
| Correction | ALWAYS | Omar explicitly corrected the agent |
| Recurrence | HIGH | Same issue hit 2+ times (check existing entries) |
| Cost-to-rediscover | HIGH | Would take >2 tool calls to figure out again |
| Blast radius | MEDIUM | Affects multiple skills, projects, or workflows |
| Decay risk | MEDIUM | Non-obvious env/config detail that changes rarely |
If NONE match → do not log. This replaces any arbitrary line-count threshold.
Never log:
- routine successes
- facts obvious from docs or code
- one-off tasks with no recurrence potential
- anything already in MEMORY.md, SOUL.md, USER.md, or AGENTS.md
Entry format
LEARNINGS.md:
- [YYYY-MM-DD] [Category]: [Actionable takeaway]
Categories: Correction, Env, Workflow, Testing, Skills, Git, Architecture
ERRORS.md:
- [YYYY-MM-DD] [Tool]: [What failed] → [Fix]
Mark fixed items with [fixed]. Delete stale entries during retention sweeps.
Retention gate
Instead of a hard line cap, score each entry periodically:
| Signal | Score |
|---|---|
| Referenced or applied in last 30 days | +3 |
| Matches active project context | +2 |
| Direct correction from Omar | +2 |
| Has prevented a repeat error | +3 |
| Env/config still valid | +1 |
| Superseded by newer entry | −5 |
| >90 days old, never referenced | −3 |
Action:
- score ≥ 2 → keep
- 0 ≤ score \x3C 2 → archive to
.learnings/ARCHIVE.md - score \x3C 0 → delete
Run this sweep during heartbeat maintenance (every ~3 days) or when LEARNINGS.md feels noisy.
Automated triggers
These fire without user prompting:
-
Post-task scan: After multi-step tasks, check for retried commands, error→workaround sequences, or avoidable file reads. If found, evaluate against write gate and log if it passes.
-
Session-start sweep: On
.learnings/LEARNINGS.mdread, flag entries >90 days old for retention scoring. -
Promotion detector: After logging, scan for entries with the same
[Category]tag appearing 3+ times. If found, auto-suggest a one-liner promotion to:- behavior/style →
SOUL.md - workflow/process →
AGENTS.md - tool/env gotcha →
TOOLS.md
- behavior/style →
-
Cross-session pattern detection: When
memory_searchreturns a daily note describing a workaround, check if.learnings/already has it. If not and it passes the write gate, log it.
Dedup
Before logging, scan existing entries for near-duplicates. If the lesson already exists, only update it if the new version is sharper or more general.
Quality bar
Every entry must help a future session avoid wasted work in under one glance.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install auto-improving-agent - 安装完成后,直接呼叫该 Skill 的名称或使用
/auto-improving-agent触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Auto Improving Agent 是什么?
Automatically capture corrections, failures, and reusable discoveries into `.learnings/` files using signal-based filtering. Triggers when the user corrects... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 167 次。
如何安装 Auto Improving Agent?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install auto-improving-agent」即可一键安装,无需额外配置。
Auto Improving Agent 是免费的吗?
是的,Auto Improving Agent 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Auto Improving Agent 支持哪些平台?
Auto Improving Agent 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Auto Improving Agent?
由 omaression(@omaression)开发并维护,当前版本 v1.0.0-alpha。