self-learning

# 🧠 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 自动提升)

## 🚀 快速开始

### 安装
```bash
# 1. 下载技能
git clone https://gith...

# 🧠 Agent Self-Learning Skill

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

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![Version](https://img.shields.io/badge/version-3.0.0-green.svg)](CHANGELOG.md)

---

## ✨ 特性

### 双引擎学习系统

#### 🔄 引擎 A: 配置文件更新
- 分析对话历史，提取关键信息
- AI 判断需要新增/删除/更新
- 自动更新 8 个核心配置文件

#### 📝 引擎 B: 学习记录系统
- 即时记录纠正、错误、功能请求
- 结构化条目 (ID/优先级/状态)
- Pattern-Key 追踪重复模式
- 自动提升到项目文件

### 企业级特性
- 💾 **安全备份** - 自动备份，支持回滚
- 📊 **完整日志** - 详细的执行日志和历史记录
- 🔧 **灵活配置** - YAML 配置文件支持
- 🧪 **单元测试** - 完整的测试覆盖
- 🌐 **通用化** - 支持任何 Agent 平台
- 🔗 **Hook 集成** - OpenClaw 自动提醒

---

## 🚀 快速开始

### 安装

```bash
# 1. 克隆项目
git clone https://github.com/Acczdy/self-learning-skill.git
cd self-learning-skill

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

# 3. 初始化学习记录目录
python3 scripts/learning_manager_cli.py --workspace /path/to/workspace init
```

### 配置文件更新

```bash
# 自动检测工作目录
python3 scripts/memory_update.py

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

# 预览模式
python3 scripts/memory_update.py --dry-run
```

### 学习记录管理

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

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

# 添加功能请求
python3 scripts/learning_manager_cli.py --workspace /path/to/workspace add-feature \
  --capability "支持 Telegram 推送"

# 查看待处理条目
python3 scripts/learning_man...