Evolution 是 Pi Agent 的自改进技能系统，用于在开发过程中持续积累知识、修正错误并验证技能内容。
用途：让 Pi Agent 在开发中把可复用的经验沉淀为技能文档，并在技能内容导致错误时自动纠正。
主要能力：自我进化，捕获新编码模式、错误调试方案、API 用法等；自我纠错，当用户按技能建议操作却编译或运行失败时，检测、确认、建议修复并记录；自我验证，定期检查代码示例、API 引用与文档是否仍然准确。
使用方式：通过 Pi Agent 的 hooks 系统自动触发。需创建或编辑 ~/.pi/hooks/evolution.ts，监听 tool_result（bash 命令后检测编译错误）、session（会话结束时提示捕获学习内容）、context（分析新模式）等事件。捕获知识后，用 workhub 创建 issue 与 PR： cd /path/to/project bun ~/.pi/agent/skills/workhub/lib.ts create issue "evolution: add new pattern" [category] bun ~/.pi/agent/skills/workhub/lib.ts create pr "evolution: add new pattern" [category] 新增内容需加进化标记，纠错需加纠正标记。
适用场景：发现新编码模式、解决疑难错误、学习 API 用法、解决构建打包问题、梳理项目结构或澄清核心概念时。
限制：应只添加通用可复用、经过验证的内容，避免项目专属代码、未验证方案、重复内容和不完整示例；具体分类与优先级以资料为准。