| name | evolution-engine |
| description | Agent 自进化引擎 (v1.0)。整合知识收割、工作流优化、模式检测、反思引擎四大模块,赋予 Agent 自我学习和持续改进能力。 |
Evolution Engine (自进化引擎)
本技能是 Agent 的"大脑升级系统",负责从经验中学习、积累知识、识别模式、持续优化。
0. Core Philosophy (核心理念)
"每一次任务都是学习机会,每一个错误都是改进素材。"
- Continuous Learning: 持续从对话和代码中提取知识
- Pattern Recognition: 识别可复用的代码和工作模式
- Self-Reflection: 定期反思,总结经验教训
- Metric-Driven: 用数据驱动优化决策
1. Modules (模块清单)
| Module | File | Trigger | Description |
|---|
| Knowledge Harvester | evolution/knowledge_base.md | 任务完成后 | 从对话中提取可复用知识 |
| Workflow Optimizer | evolution/workflow_metrics.md | 工作流完成后 | 追踪效能并提出优化建议 |
| Pattern Detector | evolution/pattern_library.md | 代码提交后 | 识别代码中的可复用模式 |
| Reflection Engine | evolution/reflection_log.md | 状态 → ARCHIVING | 自动反思并总结经验 |
| Learning Queue | evolution/learning_queue.md | 随时入队 | 管理待处理的学习素材 |
2. Commands (命令入口)
2.1 /evolve - 手动触发进化
Trigger: 用户输入 /evolve 或 "进化" / "学习"
Action:
- 处理
learning_queue.md 中所有待处理素材
- 更新
knowledge_base.md 和 pattern_library.md
- 分析
workflow_metrics.md 生成优化建议
- 输出进化报告
2.2 /reflect - 触发反思
Trigger: 用户输入 /reflect 或 "反思"
Action:
- 读取当前会话的任务完成情况
- 生成反思报告并追加到
reflection_log.md
- 提取 Action Items
2.3 /knowledge - 查询知识库
Trigger: 用户输入 /knowledge [query] 或 "知识 [query]"
Action:
- 搜索
knowledge_base.md 索引
- 读取匹配的知识条目
- 返回相关知识摘要
2.4 /patterns - 查询模式库
Trigger: 用户输入 /patterns [query] 或 "模式 [query]"
Action:
- 搜索
pattern_library.md
- 返回匹配的代码模式和模板
3. Automatic Behaviors (自动行为)
3.1 任务完成后入队
Trigger: 任何任务 (T-xxx) 标记为完成
Action:
learning_queue.add:
source_type: code_change
source_id: T-xxx
priority: P2
metadata:
files_changed: [...]
description: "..."
3.2 错误修复后入队
Trigger: Auto-Fix 成功修复错误
Action:
learning_queue.add:
source_type: error_fix
source_id: error-timestamp
priority: P1
metadata:
error_type: "..."
root_cause: "..."
solution: "..."
3.3 工作流完成后记录指标
Trigger: 工作流执行完成(成功或失败)
Action:
- 计算工作流耗时
- 记录成功/失败状态
- 追加到
workflow_metrics.md
3.4 IDLE 状态处理队列
Trigger: 状态变为 IDLE 且 learning_queue 不为空
Action:
- 处理队列中 P0/P1 优先级素材
- 更新知识库和模式库
4. Knowledge Harvester (知识收割机)
4.1 知识提取规则
从以下来源提取知识:
| Source | Extract If | Category |
|---|
| 错误修复 | 新的错误类型或解决方案 | debugging |
| 架构决策 | 重大技术选型 | architecture |
| 代码模式 | 重复出现 3+ 次 | pattern |
| 工作流优化 | 显著效率提升 | workflow |
| 工具使用 | 新工具或新技巧 | tooling |
4.2 知识条目模板
---
id: k-xxx
title: [Title]
category: [architecture|debugging|pattern|workflow|tooling]
tags: [tag1, tag2]
created: YYYY-MM-DD
confidence: 0.7
references: [source-id]
---
## Summary
[一句话总结]
## Details
[详细说明]
## Code Example (if applicable)
\`\`\`dart
// code
\`\`\`
## Related Knowledge
- k-yyy: [Related Title]
4.3 Confidence 更新规则
| Event | Confidence Change |
|---|
| 知识被再次验证 | +0.1 |
| 知识被引用使用 | +0.05 |
| 知识导致错误 | -0.2 |
| 30 天未使用 | -0.1 |
5. Pattern Detector (模式检测器)
5.1 模式识别触发
代码提交后,扫描 Git diff:
- 检查是否与已知模式匹配
- 检查是否出现新的重复结构
5.2 模式提升规则
IF pattern.occurrences >= 3 AND pattern.confidence >= 0.7
THEN promote to pattern_library as ACTIVE
5.3 复用提示
开发新功能时:
- 读取功能描述
- 搜索
pattern_library.md
- 若有匹配模式,提示复用
6. Workflow Optimizer (工作流优化器)
6.1 指标收集点
| Workflow | Collect At |
|---|
| feature-flow | 开始、PRD完成、每个任务完成、结束 |
| analyze-error | 开始、诊断完成、修复完成、结束 |
| start | 开始、上下文恢复完成、结束 |
6.2 优化建议触发
IF workflow.avg_duration > threshold * 1.5
OR workflow.success_rate < 0.8
THEN generate_optimization_suggestion()
6.3 建议模板
## Optimization Suggestion: [Workflow Name]
**Issue**: [问题描述]
**Data**:
- 平均耗时: X min (阈值: Y min)
- 成功率: X% (目标: 80%+)
- 最常见瓶颈: [Phase Name]
**Suggestion**: [优化建议]
**Expected Impact**: [预期效果]
7. Reflection Engine (反思引擎)
7.1 触发时机
- 自动: 状态从 EXECUTING 变为 ARCHIVING
- 手动: 用户输入
/reflect
7.2 反思流程
1. 读取 active_context.md 任务完成情况
2. 分析本次会话特点:
- 任务完成率
- 自动修复次数
- 回滚次数
- 耗时分布
3. 生成反思报告 (What Went Well / What Could Improve)
4. 提取 Learnings (转化为知识条目)
5. 提取 Action Items (转化为待办事项)
6. 追加到 reflection_log.md
7.3 Action Item 跟踪
Action Items 追加到 active_context.md 的任务队列中,标记为 [REFLECTION]:
- [ ] [REFLECTION] 将 Loading Pattern 标准化为代码模板
8. Evolution Report (进化报告)
执行 /evolve 后,输出进化报告:
# 🧬 Evolution Report - YYYY-MM-DD
## 📚 Knowledge Updated
- **New**: X items
- **Updated**: X items
- **Deprecated**: X items
## 🔄 Patterns Detected
- **New**: X patterns
- **Promoted**: X patterns
## 📊 Workflow Insights
- **Most Used**: [Workflow Name]
- **Bottleneck**: [Phase Name]
- **Optimization Suggestions**: X
## 💭 Reflections Processed
- **Sessions**: X
- **Action Items Completed**: X/Y
## 🎯 Recommended Next Steps
1. [Action 1]
2. [Action 2]
9. Integration Points (集成点)
9.1 与 context-manager 集成
- 反思结果写入
active_context.md
- 进化状态更新 frontmatter
9.2 与 feature-flow 集成
9.3 与 analyze-error 集成
- 错误修复后触发知识入队
- 更新
project_decisions.md 的 Known Issues
9.4 与 GEMINI.md (全局配置) 集成
- 注册
/evolve, /reflect, /knowledge, /patterns 命令
- 添加自动行为触发器
10. Data Retention (数据保留)
| Data | Retention | Archive Policy |
|---|
| Knowledge Items | 永久 (Confidence > 0.5) | Confidence < 0.5 → deprecated → 7天后删除 |
| Workflow Metrics | 90 天详情,永久统计 | 90 天前详情归档 |
| Pattern Library | 永久 (Occurrences >= 3) | Occurrences < 3 → pending |
| Reflection Log | 永久摘要,30 天详情 | 30 天前详情归档 |
| Learning Queue | 处理后 7 天 | 7 天后删除 |
Last Updated: 2026-02-08