Agent Self Evolution — AI skill for Claude Code

提醒: Pi 平台支持最完整；Claude Code 与 Codex 适配（Stop hook 采集）已包含隔离测试验证，Codex 需 0.147+ 且首次运行需信任 hook。

agent-self-evolution

**The agent that grows with you.** 一个让 AI 编程助手从每次任务中自动学习、沉淀经验、进化技能的开源系统。

[](LICENSE) [](core/collect.py) [](platforms/) [](CHANGELOG.md)

agent-self-evolution 借鉴 [Hermes Agent Self-Evolution](https://github.com/NousResearch/hermes-agent-self-evolution) 的设计哲学，为 AI 编码助手（pi / Claude Code / Codex）打造一套完整的「**经验 → 技能 → 进化**」学习闭环：

• 每次任务结束后，系统在后台安静地分析会话轨迹，把值得复用的经验自动草拟成技能候选；
• 你手动说一句「总结一天的工作」或「进化」，系统就会审查候选、启用好技能、维护长期记忆、沉淀踩坑教训；
• 日积月累，你的 agent 会越来越懂你的环境、你的工具链、你踩过的每一个坑。

---

目录

• 为什么需要它
• 工作原理
• 支持平台
• 快速开始（完整安装指引 INSTALL.md）
• 核心概念详解
• 优势：为什么值得用
• 风险与注意事项（请务必阅读）
• 安全与隐私模型
• 配置项
• 常见问题 FAQ
• 与 Hermes 的关系
• 贡献
• License

---

为什么需要它

AI 编码助手是**无状态**的：一次任务中学到的经验，下次任务就忘了。常见痛点：

痛点	现状	本系统的解法
同样的坑反复踩	每次排错都从零开始	踩坑经验沉淀进 LESSONS.md，下次直接查证
复杂流程无法复用	部署/排错步骤散落在对话历史里	自动草拟成 SKILL.md 技能，随时调用
用户偏好记不住	每次都要重新叮嘱	用户画像 USER.md 持续维护
技能库膨胀失控	装了一堆技能不知道哪些还有用	使用统计 + 健康度反馈 + 归档机制，三级体检
记忆不可追溯	改了什么、为什么改，无从查起	明文文件 + 经验日志 + git 历史

---

工作原理

        ┌─────────────────────────────────────────────────────────┐
        │                        一次任务                         │
        └──────────────────────────┬──────────────────────────────┘
                                   ▼
        ┌─────────────────────────────────────────────────────────┐
        │   [采集器] 任务结束后后台分析轨迹（hook 自动触发）          │
        │   统计工具调用 / 错误修复 → 满足条件？                     │