keep-learning-agent（保持学习 Agent）

Keep Learning Agent - 持续学习系统

统一的知识沉淀和经验固化系统 核心理念：学到的东西必须固化成可复用的模块和文档，而不是只存在于临时会话中

🎯 核心功能

📁 目录结构

.learnings/
├── README.md                    # 使用指南
├── INDEX.md                     # 快速索引（自动更新）
├── LEARNINGS.md                 # 主学习记录
├── ERRORS.md                    # 错误记录
├── FEATURE_REQUESTS.md          # 功能请求
├── INTEGRATION-REPORT.md        # 整合报告
├── TEMPLATE-ANALYSIS.md         # 模板分析报告
├── templates/
│   └── learning-template.md     # 统一模板
└── archive/                     # 已归档学习
    └── 2026-03/

lib/
├── feishu_api.py                # 可复用模块示例
├── README.md                    # 库文档
└── KNOWLEDGE-SOP.md             # 知识固化 SOP

G:\clawbot\config\
├── self-repair.ps1              # 自我修复脚本
├── autoload-configs.ps1         # 配置自动加载
└── skills-config.json           # 技能配置注册表

📝 学习记录模板

标准格式

## [LRN-YYYYMMDD-XXX] 简短标题

**Logged**: 2026-03-04T15:45:00+08:00
**Priority**: low | medium | high | critical
**Status**: new | in_progress | resolved | promoted | archived
**Category**: technical_solution | process_improvement | mindset | bug_fix | feature_request
**Area**: integration | automation | memory | api | ui | cognitive | config
**Source**: conversation | error | user_feedback | self_discovery

### 问题描述
清晰描述遇到的问题和背景

### 根因分析
用 5Why 或其他方法找到根本原因

### 解决方案
详细的解决步骤和代码

### 可复用场景
列出可以复用的场景

### 代码/脚本
可复用的代码片段或脚本位置

### 依赖
需要的库、配置、权限等

### 测试结果
测试时间、结果

### 关联
- **Related**: [LRN-XXXX-XXX](#lrn-xxxx-xxx)
- **See Also**: [文档链接](url)
- **Tags**: tag1, tag2

### Metadata
- **Pattern-Key**: unique.pattern.key
- **Recurrence-Count**: 1
- **First-Seen**: 2026-03-04
- **Last-Seen**: 2026-03-04
- **Time-Spent**: 30min
- **Skill-Path**: skills/skill-name (if promoted_to_skill)

字段说明

🔄 状态流转

new → in_progress → resolved → promoted → archived
              ↓
          abandoned (明确不做)

🏷️ 分类体系

按优先级

按类别

按领域

🤖 自动化集成

会话启动流程

# 1. 读取核心文件
Read SOUL.md, AGENTS.md, MEMORY.md
Read memory/YYYY-MM-DD.md

# 2. 运行自我修复
G:\clawbot\config\self-repair.ps1

# 3. 加载配置
G:\clawbot\config\autoload-configs.ps1

# 4. 查看索引
Read .learnings/INDEX.md

self-repair.ps1 功能

# 检查 pending 学习项
# 提取 Pattern-Key
# 检查是否已应用改进
# 输出待办清单
# 提示更新 INDEX.md

定期维护

# 每周日执行
1. 检查 new 超过 3 天的 → 安排优先级
2. 检查 resolved 超过 7 天的 → 提醒封装
3. 归档已 promoted 的 → 移入 archive/
4. 更新 INDEX.md → 刷新索引

📊 索引系统

INDEX.md 提供快速查找：

# 学习索引

## 概况
| 状态 | 数量 |
|------|------|
| new | 1 |
| resolved | 9 |
| promoted | 4 |

## 按类别
- technical_solution: 3
- process_improvement: 3
- mindset: 4

## 按 Pattern-Key
- `feishu.api-direct`: LRN-20260304-009
- `memory.persistent`: LRN-20260304-008

## 待办
- [ ] LRN-20260304-012 知识固化 SOP

📈 质量指标

好的学习记录 ✅

• 问题描述清晰
• 根因分析深入（5Why）
• 解决方案可复用
• 有代码/脚本
• 有测试结果
• Pattern-Key 唯一
• 状态及时更新

差的学习记录 ❌

• 只有问题描述
• 没有根因分析
• 无法复用
• 没有 Pattern-Key
• 状态一直是 new

🚀 快速开始

记录新学习

1. 复制模板：.learnings/templates/learning-template.md
2. 填写内容
3. 追加到：.learnings/LEARNINGS.md
4. 更新索引：.learnings/INDEX.md

查找已有学习

# 按关键词
Select-String -Path ".learnings/LEARNINGS.md" -Pattern "飞书"

# 按 Pattern-Key
Select-String -Path ".learnings/LEARNINGS.md" -Pattern "Pattern-Key:.*feishu"

# 按状态
Select-String -Path ".learnings/LEARNINGS.md" -Pattern "Status\*: resolved"

封装可复用模块

1. 解决方案验证成功
2. 创建 lib/xxx.py 模块
3. 更新 lib/README.md
4. 标记状态为 resolved
5. 更新 INDEX.md

📚 相关文档

🎓 设计原则

1. 单一来源 - 只有一个 LEARNINGS.md
2. 统一格式 - 所有学习用同一模板
3. 可查找 - INDEX.md 提供快速索引
4. 可操作 - self-repair 自动检查 pending 项
5. 定期整理 - 每周/每月归档
6. 可复用 - 封装成 lib/ 模块

📝 版本历史

*创建原因：阿 sir 教导「学到的东西应该固化成标准化经验方法」* *作者：小咪 (XiaoMi)* *最后更新：2026-03-04*