Self Evolver — 自我进化引擎
版本： 1.0.0 适用对象： QClaw 等 AI Agent 依赖： Python 3.8+, 无需外部库
核心能力
帮助 AI Agent 建立「从经验中持续自我进化」的能力，核心三大模块：
| 模块 | 做什么 | 触发方式 |
|---|---|---|
| SEA 进化循环 | 从错误/纠正中提炼改进，3天周期扫描 | cron |
| 纠正自动记录 | 被用户纠正时自动记录到学习档案 | 关键词检测 |
| 技能自进化 | 从任务历史自动发现可固化的技能 | 关键词检测 |
触发条件
当用户说「帮我安装自我进化」或「安装 self-evolver」或「你要有自我进化能力」时，触发本 skill。
安装后 AI 会：
- 创建
.learnings/目录结构 - 注册每 3 天一次的 SEA 进化扫描 cron
- 激活纠正自动记录机制
使用方法
1. 安装（首次）
skillhub_install install_skill self-evolver
或在 OpenClaw 中对 AI 说：
「安装自我进化能力」
AI 会自动完成：
- 创建
.learnings/目录（含 LEARNINGS.md / ERRORS.md / FEATURE_REQUESTS.md） - 注册 cron：
每3天运行 SEA 进化扫描 - 生成
SKILL.md覆盖本文件
2. 日常使用
| 场景 | 操作 |
|---|---|
| 被纠正了 | AI 自动检测纠正关键词 → 写入 pending → 下次 heartbeat 合并 |
| 想要手动进化 | 说「自我反思」「进化一下」「帮我分析最近的错误」 |
| 查看学习记录 | 说「我最近学到了什么」「看一下记忆」 |
| 新技能候选出现 | AI 自动检测关键词 → 生成候选技能写入 skills/ |
3. 手动触发进化
python ~/.qclaw/workspace/scripts/evolve.py
核心脚本说明
evolve.py（SEA 进化引擎）
核心流程：
Sense（感知）→ Assess（评估）→ Evolve（进化）
Sense（感知）：
- 扫描 7 天内所有学习记录（LEARNINGS.md / ERRORS.md）
- 识别高优先级（Priority=高）未处理项
- 识别连续重复错误（出现 ≥3 次）
Assess（评估）：
- 技能健康度诊断（fallback_rate / completion_rate / effective_rate）
- 行为模式识别（从对话历史提取）
- 学习效率评分
Evolve（进化）：
- 对连续错误 → 更新系统提示词 / AGENTS.md
- 对重复任务 → 触发技能自进化生成新 skill
- 生成进化报告
auto_learn.py（纠正自动记录）
触发关键词：
- 打断/纠正：不對、错了、不是、等等、重新、更正、纠正
- 质疑：不對、我没说过、不用、不需要
工作流：
- 检测到纠正 → 立即写入
pending.md - 下次 heartbeat → flush 到
LEARNINGS.md - 高优先级纠正 → 立即触发 SEA 扫描
skill_evolution.py（技能自进化）
检测关键词（任务后分析）：
- 研究、开发、分析、优化、自动化、监控、集成、部署、测试、重构
生成规则：
- 同一模式出现 ≥3 次 → 生成候选技能
- 生成
skills/[pattern]-skill/SKILL.md - cron 定期 Nudge 提醒优化
目录结构
~/.qclaw/workspace/
├── .learnings/
│ ├── LEARNINGS.md # 纠正与改进记录
│ ├── ERRORS.md # 命令/操作失败记录
│ ├── FEATURE_REQUESTS.md # 用户请求的功能
│ ├── pending.md # 待合并的纠正（心跳时处理）
│ └── assessment-report.json # 技能健康度报告
├── scripts/
│ ├── evolve.py # SEA 进化引擎
│ ├── auto_learn.py # 纠正自动记录
│ ├── skill_evolution.py # 技能自进化
│ └── assess.py # 技能质量评估
├── skills/ # 自生成的技能目录
│ └── [pattern]-skill/
│ └── SKILL.md
└── skill_metrics.json # 技能使用指标
记录格式（LEARNINGS.md）
| 时间 | 错误做法 | 正确做法 | 区域 | Priority |
进化报告格式
## 进化扫描报告 — YYYY-MM-DD
### Sense（感知）
- 待处理纠正：N 条
- 连续错误：N 条
- 高优先级：N 条
### Assess（评估）
- 总技能数：N
- 健康技能：N
- 需进化技能：N
### Evolve（进化）
- 已生成技能：N
- 已更新规则：N
- 待确认改进：N
安装检查清单
-
.learnings/目录存在 -
scripts/evolve.py存在 -
scripts/auto_learn.py存在 -
scripts/skill_evolution.py存在 - cron 任务已注册（每3天）
-
skill_metrics.json可写
与 QClaw 原版的区别
本 skill 是给新 Agent 的完整版，包含 QClaw 经过多次迭代后的所有最佳实践。新 Agent 安装后即可获得：
- SEA 三阶段进化循环
- 纠正即学习（自动记录 + 合并）
- 技能自生长（从任务历史自动生成）
- 三层记忆（HOT/WARM/COLD）
- 技能健康度监控
无需额外配置，开箱即用。