name: self-learning description: | Agent 自我学习与记忆更新技能。分析对话历史，提取关键信息，自动更新配置文件和学习记录，实现 Agent 持续自我成长。融合自学习 (配置文件更新) + 自改进 (学习记录系统) 双引擎。

Use this skill when:

需要整理和更新 Agent 记忆 (MEMORY.md, IDENTITY.md 等)
对话中产生了新的配置信息或用户偏好
用户纠正 Agent 或发现错误时 (记录到 .learnings/)
定期执行 Agent 自我优化
清理过时的配置和记忆

Triggers: 自我学习、记忆更新、配置优化、Agent 成长、整理记忆、记录学习、纠正错误 version: 3.0.1 author: Acczdy license: MIT repository: https://github.com/Acczdy/self-learning-skill allowed-tools:

Read
Write
Bash
SessionsList
SessionsHistory
SessionsSend files:
scripts/memory_update.py: 主执行脚本 (配置文件更新)
scripts/learning_manager.py: 学习记录管理
.learnings/LEARNINGS.md: 学习记录模板
.learnings/ERRORS.md: 错误记录模板
.learnings/FEATURE_REQUESTS.md: 功能请求模板
config.yaml: 配置文件
hooks/openclaw/: OpenClaw Hook 集成
requirements.txt: Python 依赖
README.md: 使用说明

🧠 Agent 自我学习技能

让 Agent 通过分析对话历史，自动提取关键信息并更新配置文件，实现持续自我成长。

通用化设计 | 多平台支持 | 学习记录系统 | Hook 集成

🎯 核心功能

1. 双引擎学习系统 🚀

引擎 A: 配置文件更新 (Memory Update)

分析过去 24 小时的对话内容
AI 智能判断需要新增、删除还是更新
自动更新 8 个核心配置文件

引擎 B: 学习记录系统 (Learning Log)

即时记录用户纠正、错误、功能请求
结构化条目 (ID/优先级/状态/分类)
支持提升到项目文件 (SOUL.md, AGENTS.md, TOOLS.md)
Pattern-Key 追踪重复模式

2. 通用化设计 ✅

不局限于特定平台 (OpenClaw/其他)
工作目录自动检测
配置文件支持
环境变量支持

3. 配置文件更新

自动更新 8 个核心配置文件：

MEMORY.md - 长期记忆 (必须)
IDENTITY.md - Agent 身份
USER.md - 用户信息
TOOLS.md - 工具配置
SOUL.md - 人格定义
AGENTS.md - 使用指南
BOOTSTRAP.md - 初始化引导
HEARTBEAT.md - 心跳任务

4. 学习记录文件

自动创建和管理 .learnings/ 目录:

LEARNINGS.md - 纠正、知识缺口、最佳实践
ERRORS.md - 命令失败、异常
FEATURE_REQUESTS.md - 用户请求的功能

5. 条目 ID 系统

类型	格式	示例
学习	`LRN-YYYYMMDD-XXX`	`LRN-20250115-001`
错误	`ERR-YYYYMMDD-XXX`	`ERR-20250115-A3F`
功能	`FEAT-YYYYMMDD-XXX`	`FEAT-20250115-002`

6. 提升规则 (Promotion)

当学习内容广泛适用时，自动提升到项目文件:

学习类型	提升到	示例
行为模式	`SOUL.md`	"简洁回复，避免免责声明"
工作流改进	`AGENTS.md`	"长任务使用子代理"
工具技巧	`TOOLS.md`	"Git push 需要先配置认证"
项目约定	`CLAUDE.md`	"使用 pnpm 而非 npm"

7. Hook 集成 🔗

onSessionStart: 会话开始时检查待处理高优先级条目
onPromptSubmit: 检测用户纠正信号，建议记录

8. 企业级特性

✅ 完整的日志系统
✅ 执行历史记录
✅ 文件验证机制
✅ 自动备份与回滚
✅ 预览模式
✅ 单元测试覆盖
✅ 重复模式检测 (Recurrence-Count >= 3 自动提升)

🚀 快速开始

安装

# 1. 下载技能
git clone https://github.com/Acczdy/self-learning-skill.git
cd self-learning-skill

# 2. 安装依赖
pip install -r requirements.txt

# 3. 复制配置文件
cp config.yaml config.yaml

# 4. 初始化学习记录目录 (可选)
python3 scripts/learning_manager.py --init

基本使用

# 自动检测工作目录并执行学习
python3 scripts/memory_update.py

# 指定工作目录
python3 scripts/memory_update.py --workspace /path/to/workspace

# 预览模式 (不实际执行)
python3 scripts/memory_update.py --dry-run

# 使用自定义配置
python3 scripts/memory_update.py --config my_config.yaml

学习记录命令

# 添加学习记录
python3 scripts/learning_manager.py add-learning \
  --category "correction" \
  --summary "用户纠正了 API 用法" \
  --priority "high"

# 添加错误记录
python3 scripts/learning_manager.py add-error \
  --command "git push" \
  --error "permission denied"

# 添加功能请求
python3 scripts/learning_manager.py add-feature \
  --capability "支持 Telegram 推送" \
  --complexity "medium"

# 查看待处理高优先级条目
python3 scripts/learning_manager.py list-pending

# 检查重复模式
python3 scripts/learning_manager.py check-recurring

Hook 配置 (OpenClaw)

# 复制 Hook 到 OpenClaw
cp -r hooks/openclaw ~/.openclaw/hooks/self-learning

# 启用 Hook
openclaw hooks enable self-learning

# 禁用 Hook
openclaw hooks disable self-learning

📋 执行流程

1. 自动检测工作目录
   ↓
2. 读取核心配置文件
   ↓
3. 获取对话历史
   ↓
4. AI 智能分析
   ↓
5. 备份配置文件
   ↓
6. 执行更新操作
   ↓
7. 验证文件有效性
   ↓
8. 创建每日记忆
   ↓
9. 保存执行历史
   ↓
10. 清理旧备份
   ↓
完成 ✅

⚠️ 安全特性

备份保护

更新前自动备份
保留 7 天备份
最多保留 10 个备份
支持手动回滚

文件验证

Markdown 语法检查
更新后自动验证
失败自动回滚

删除保护

删除操作需确认
最大删除数量限制
删除理由必须明确

📊 输出示例

============================================================
🧠 Agent 自我学习开始 (main)
⏰ 时间：2026-03-05 01:30:00
📁 工作目录：/root/.openclaw/workspace
============================================================

📖 读取配置文件...
✅ 已读取 8 个配置文件

💾 备份配置文件...
💾 已备份到：/root/.openclaw/workspace/.backup/20260305_013000

📝 执行更新...
✅ 完成：MEMORY.md
✅ 完成：TOOLS.md

📅 创建每日记忆...
📜 保存执行历史...
🗑️ 清理旧备份...

============================================================
✅ Agent 自我学习完成 (main)
============================================================

🔧 配置说明

config.yaml

# 工作目录
workspace:
  default: ./workspace
  auto_detect: true

# 备份配置
backup:
  enabled: true
  retain_days: 7
  max_backups: 10

# 日志配置
logging:
  enabled: true
  level: INFO

# 安全配置
safety:
  validate_after_update: true
  max_delete_count: 10

📁 项目结构

self-learning-skill/
├── scripts/
│   ├── memory_update.py    # 主执行脚本
│   └── publish.sh          # 发布脚本
├── tests/
│   └── test_main.py        # 单元测试
├── examples/
│   ├── config.minimal.yaml # 最小化配置
│   └── config.full.yaml    # 完整配置
├── SKILL.md                # Skill 定义
├── README.md               # 使用说明
├── config.yaml             # 配置文件
├── requirements.txt        # Python 依赖
├── LICENSE                 # MIT 许可证
├── CHANGELOG.md            # 更新日志
└── .gitignore              # Git 忽略文件

🧪 测试

# 运行单元测试
python3 -m pytest tests/

# 运行特定测试
python3 -m pytest tests/test_main.py::TestConfig

📈 版本历史

版本	日期	更新内容
2.0.0	2026-03-05	通用化重构、日志系统、测试覆盖
1.1.0	2026-03-05	多 Agent 支持
1.0.0	2026-03-05	初始版本

🤝 贡献

欢迎提交 Issue 和 Pull Request！

Fork 项目
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
开启 Pull Request

📄 许可证

MIT License - 详见 LICENSE 文件

📞 支持

问题反馈：GitHub Issues
讨论交流：GitHub Discussions

最后更新：2026-03-05

Self Learning Skill

Description