自我改进技能
将学习内容和错误记录到 Markdown 文件中,以实现持续改进。编码代理可以后续处理这些记录以修复问题,重要的学习内容会被提升为项目记忆。
快速参考
| 情况 | 操作 |
|---|---|
| 命令/操作失败 | 记录到 .learnings/ERRORS.md |
| 用户纠正你 | 记录到 .learnings/LEARNINGS.md,类别为 correction |
| 用户想要缺失功能 | 记录到 .learnings/FEATURE_REQUESTS.md |
| API/外部工具失败 | 记录到 .learnings/ERRORS.md,并包含集成细节 |
| 知识过时 | 记录到 .learnings/LEARNINGS.md,类别为 knowledge_gap |
| 发现更好的方法 | 记录到 .learnings/LEARNINGS.md,类别为 best_practice |
| 与现有条目相似 | 使用 **另见** 链接,考虑提升优先级 |
| 广泛适用的学习 | 提升到 CLAUDE.md、AGENTS.md 和/或 .github/copilot-instructions.md |
| 工作流改进 | 提升到 AGENTS.md(OpenClaw 工作区) |
| 工具陷阱 | 提升到 TOOLS.md(OpenClaw 工作区) |
| 行为模式 | 提升到 SOUL.md(OpenClaw 工作区) |
OpenClaw 设置(推荐)
OpenClaw 是该技能的主要平台。它使用基于工作区的提示词注入,并自动加载技能。
安装
通过 ClawdHub(推荐):
clawdhub install self-improving-agent
手动安装:
git clone https://github.com/peterskoett/self-improving-agent.git ~/.openclaw/skills/self-improving-agent
工作区结构
OpenClaw 将以下文件注入到每个会话中:
~/.openclaw/workspace/
├── AGENTS.md # 多代理工作流、委派模式
├── SOUL.md # 行为准则、个性、原则
├── TOOLS.md # 工具能力、集成陷阱
├── MEMORY.md # 长期记忆(仅主会话)
├── memory/ # 每日记忆文件
│ └── YYYY-MM-DD.md
└── .learnings/ # 此技能的日志文件
├── LEARNINGS.md
├── ERRORS.md
└── FEATURE_REQUESTS.md
创建学习文件
mkdir -p ~/.openclaw/workspace/.learnings
然后创建日志文件(或从 assets/ 复制):
LEARNINGS.md— 纠正、知识空白、最佳实践ERRORS.md— 命令失败、异常FEATURE_REQUESTS.md— 用户请求的功能
提升目标
当学习内容被证明广泛适用时,将其提升到工作区文件:
| 学习类型 | 提升到 | 示例 |
|---|---|---|
| 行为模式 | SOUL.md | “保持简洁,避免免责声明” |
| 工作流改进 | AGENTS.md | “为长任务生成子代理” |
| 工具陷阱 | TOOLS.md | “Git push 需要先配置认证” |
会话间通信
OpenClaw 提供了跨会话共享学习内容的工具:
- sessions_list — 查看活动/最近会话
- sessions_history — 读取其他会话的转录
- sessions_send — 向其他会话发送学习内容
- sessions_spawn — 生成子代理进行后台工作
可选:启用钩子
用于在会话开始时自动提醒:
# 将钩子复制到 OpenClaw 钩子目录
cp -r hooks/openclaw ~/.openclaw/hooks/self-improvement
# 启用它
openclaw hooks enable self-improvement
有关完整详情,请参阅 references/openclaw-integration.md。
通用设置(其他代理)
对于 Claude Code、Codex、Copilot 或其他代理,请在项目中创建 .learnings/ 目录:
mkdir -p .learnings
从 assets/ 复制模板或创建带有标题的文件。
日志格式
学习条目
追加到 .learnings/LEARNINGS.md:
## [LRN-YYYYMMDD-XXX] category
**记录时间**:ISO-8601 时间戳
**优先级**:low | medium | high | critical
**状态**:pending
**领域**:frontend | backend | infra | tests | docs | config
### 摘要
所学内容的一句话描述
### 详情
完整上下文:发生了什么,什么错了,什么是正确的
### 建议操作
具体的修复或改进措施
### 元数据
- 来源:conversation | error | user_feedback
- 相关文件:path/to/file.ext
- 标签:tag1, tag2
- 另见:LRN-20250110-001(如果与现有条目相关)
---
错误条目
追加到 .learnings/ERRORS.md:
## [ERR-YYYYMMDD-XXX] skill_or_command_name
**记录时间**:ISO-8601 时间戳
**优先级**:high
**状态**:pending
**领域**:frontend | backend | infra | tests | docs | config
### 摘要
对失败内容的简要描述
### 错误
实际的错误消息或输出
### 上下文
- 尝试的命令/操作
- 使用的输入或参数
- 相关的环境细节
### 建议修复
如果可识别,可能解决此问题的方案
### 元数据
- 可重现:yes | no | unknown
- 相关文件:path/to/file.ext
- 另见:ERR-20250110-001(如果重复出现)
---
功能请求条目
追加到 .learnings/FEATURE_REQUESTS.md:
## [FEAT-YYYYMMDD-XXX] capability_name
**记录时间**:ISO-8601 时间戳
**优先级**:medium
**状态**:pending
**领域**:frontend | backend | infra | tests | docs | config
### 请求的功能
用户想要做什么
### 用户上下文
为什么用户需要它,他们在解决什么问题
### 复杂度评估
simple | medium | complex
### 建议实现
如何构建这个功能,它可能扩展什么
### 元数据
- 频率:first_time | recurring
- 相关功能:existing_feature_name
---
ID 生成
格式:TYPE-YYYYMMDD-XXX
- TYPE:
LRN(学习)、ERR(错误)、FEAT(功能) - YYYYMMDD:当前日期
- XXX:序号或随机 3 个字符(例如
001、A7B)
示例:LRN-20250115-001、ERR-20250115-A3F、FEAT-20250115-002
解决条目
当问题解决后,更新条目:
- 将
**状态**: pending改为**状态**: resolved - 在元数据后添加解决块:
### 解决方案
- **解决时间**:2025-01-16T09:00:00Z
- **提交/PR**:abc123 或 #42
- **备注**:所做工作的简要描述
其他状态值:
in_progress- 正在积极处理wont_fix- 决定不处理(在解决方案备注中添加原因)promoted- 已提升到 CLAUDE.md、AGENTS.md 或 .github/copilot-instructions.md
提升到项目记忆
当一条学习内容广泛适用(非一次性修复)时,将其提升到永久项目记忆。
何时提升
- 学习内容适用于多个文件/功能
- 任何贡献者(人类或 AI)都应了解的知识
- 防止重复错误
- 记录项目特定约定
提升目标
| 目标 | 应归属内容 |
|---|---|
CLAUDE.md | 项目事实、约定、所有 Claude 交互的陷阱 |
AGENTS.md | 代理特定工作流、工具使用模式、自动化规则 |
.github/copilot-instructions.md | GitHub Copilot 的项目上下文和约定 |
SOUL.md | 行为准则、沟通风格、原则(OpenClaw 工作区) |
TOOLS.md | 工具能力、使用模式、集成陷阱(OpenClaw 工作区) |
如何提升
- 提炼 将学习内容浓缩为简洁的规则或事实
- 添加 到目标文件中的相应部分(如果文件不存在则创建)
- 更新 原始条目:
- 将
**状态**: pending改为**状态**: promoted - 添加
**提升到**: CLAUDE.md、AGENTS.md或.github/copilot-instructions.md
- 将
提升示例
学习内容(冗长):
项目使用 pnpm 工作区。尝试
npm install但失败了。 锁定文件是pnpm-lock.yaml。必须使用pnpm install。
在 CLAUDE.md 中(简洁):
## 构建 & 依赖
- 包管理器:pnpm(不是 npm)- 请使用 `pnpm install`
学习内容(冗长):
修改 API 端点后,必须重新生成 TypeScript 客户端。 忘记此步骤会导致运行时类型不匹配。
在 AGENTS.md 中(可操作):
## API 更改后
1. 重新生成客户端:`pnpm run generate:api`
2. 检查类型错误:`pnpm tsc --noEmit`
重复模式检测
如果记录的条目与现有条目相似:
- 先搜索:
grep -r "keyword" .learnings/ - 链接条目:在元数据中添加
**另见**: ERR-20250110-001 - 提升优先级:如果问题持续重复
- 考虑系统性修复:重复问题通常表明:
- 缺少文档(→ 提升到 CLAUDE.md 或 .github/copilot-instructions.md)
- 缺少自动化(→ 添加到 AGENTS.md)
- 架构问题(→ 创建技术债务票据)
定期审查
在自然断点审查 .learnings/ 目录:
何时审查
- 开始新的主要任务之前
- 完成一个功能之后
- 处理包含过去学习内容的领域时
- 活跃开发期间每周一次
快速状态检查
# 统计待处理项目数
grep -h "Status\*\*: pending" .learnings/*.md | wc -l
# 列出高优先级待处理项目
grep -B5 "Priority\*\*: high" .learnings/*.md | grep "^## \["
# 查找特定领域的学习内容
grep -l "Area\*\*: backend" .learnings/*.md
审查操作
- 解决已修复的项目
- 提升适用的学习内容
- 链接相关条目
- 上报重复问题
检测触发器
当发现以下情况时自动记录:
纠正(→ 类别为 correction 的学习):
- “不,那不是...”
- “实际上,应该是...”
- “你关于...是错的”
- “那已经过时了...”
功能请求(→ 功能请求):
- “你还能...”
- “我希望你能...”
- “有没有办法...”
- “为什么你不能...”
知识空白(→ 类别为 knowledge_gap 的学习):
- 用户提供了你不知道的信息
- 你参考的文档已过时
- API 行为与你理解的不同
错误(→ 错误条目):
- 命令返回非零退出码
- 异常或堆栈跟踪
- 意外输出或行为
- 超时或连接失败
优先级指南
| 优先级 | 何时使用 |
|---|---|
critical | 阻塞核心功能、存在数据丢失风险、安全问题 |
high | 显著影响、影响常见工作流、重复问题 |
medium | 中等影响、存在变通方法 |
low | 轻微不便、边缘情况、锦上添花 |
领域标签
用于按代码库区域筛选学习内容:
| 领域 | 范围 |
|---|---|
frontend | UI、组件、客户端代码 |
backend | API、服务、服务器端代码 |
infra | CI/CD、部署、Docker、云 |
tests | 测试文件、测试工具、覆盖率 |
docs | 文档、注释、README |
config | 配置文件、环境、设置 |
最佳实践
- 立即记录 - 问题发生后上下文最新鲜
- 具体化 - 未来的代理需要快速理解
- 包含重现步骤 - 特别是对于错误
- 链接相关文件 - 使修复更容易
- 建议具体修复 - 不仅仅是“调查”
- 使用一致的类别 - 支持筛选
- 积极提升 - 如有疑问,添加到 CLAUDE.md 或 .github/copilot-instructions.md
- 定期审查 - 过时的学习会失去价值
Gitignore 选项
将学习内容保留在本地(每位开发者):
.learnings/
在仓库中跟踪学习内容(团队共享): 不要添加到 .gitignore - 学习内容成为共享知识。
混合模式(跟踪模板,忽略条目):
.learnings/*.md
!.learnings/.gitkeep
钩子集成
通过代理钩子启用自动提醒。这是可选的 - 您必须显式配置钩子。
快速设置(Claude Code / Codex)
在您的项目中创建 .claude/settings.json:
{
"hooks": {
"UserPromptSubmit": [{
"matcher": "",
"hooks": [{
"type": "command",
"command": "./skills/self-improvement/scripts/activator.sh"
}]
}]
}
}
这会在每次提示后注入学习评估提醒(约 50-100 tokens 的开销)。
完整设置(含错误检测)
{
"hooks": {
"UserPromptSubmit": [{
"matcher": "",
"hooks": [{
"type": "command",
"command": "./skills/self-improvement/scripts/activator.sh"
}]
}],
"PostToolUse": [{
"matcher": "Bash",
"hooks": [{
"type": "command",
"command": "./skills/self-improvement/scripts/error-detector.sh"
}]
}]
}
}
可用钩子脚本
| 脚本 | 钩子类型 | 目的 |
|---|---|---|
scripts/activator.sh | UserPromptSubmit | 在任务后提醒评估学习内容 |
scripts/error-detector.sh | PostToolUse (Bash) | 在命令错误时触发 |
有关详细配置和故障排除,请参阅 references/hooks-setup.md。
自动技能提取
当学习内容有价值到足以成为可重用的技能时,使用提供的助手进行提取。
技能提取标准
当满足以下任一条件时,学习内容符合技能提取资格:
| 标准 | 描述 |
|---|---|
| 重复出现 | 有 2 个以上类似问题的 另见 链接 |
| 已验证 | 状态为 resolved 且有可行的修复 |
| 非显而易见 | 需要实际调试/调查才能发现 |
| 广泛适用 | 非项目特定;跨代码库有用 |
| 用户标记 | 用户说“将其保存为技能”或类似的话 |
提取工作流
- 识别候选:学习内容满足提取标准
- 运行助手(或手动创建):
./skills/self-improvement/scripts/extract-skill.sh skill-name --dry-run ./skills/self-improvement/scripts/extract-skill.sh skill-name - 自定义 SKILL.md:用学习内容填充模板
- 更新学习:将状态设置为
promoted_to_skill,添加Skill-Path - 验证:在新会话中阅读以确保其自包含
手动提取
如果您更喜欢手动操作...