feat(growth): L2 技能进化核心 — PatternAggregator+SkillGenerator+QualityGate+EvolutionEngine
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled

- PatternAggregator: 经验模式聚合,找出 reuse_count>=threshold 的可固化模式
- SkillGenerator: LLM prompt 构建 + JSON 解析 + 自动提取 JSON 块
- QualityGate: 置信度/冲突/格式质量门控
- EvolutionEngine: 中枢调度器,协调 L2 触发检查+技能生成+质量验证

新增 24 个测试(87→111),全 workspace 0 error。
This commit is contained in:
iven
2026-04-18 21:09:48 +08:00
parent 8d218e9ab9
commit 415abf9e66
5 changed files with 822 additions and 0 deletions

View File

@@ -0,0 +1,201 @@
//! 进化引擎中枢
//! 协调 L1/L2/L3 三层进化的触发和执行
//! L1 (记忆进化) 在 GrowthIntegration 中处理
//! L2 (技能进化) 通过 PatternAggregator + SkillGenerator + QualityGate 协调
//! L3 (工作流进化) 预留接口Phase 4 实现
use std::sync::Arc;
use crate::experience_store::ExperienceStore;
use crate::pattern_aggregator::{AggregatedPattern, PatternAggregator};
use crate::quality_gate::{QualityGate, QualityReport};
use crate::skill_generator::{SkillCandidate, SkillGenerator};
use crate::VikingAdapter;
use zclaw_types::Result;
/// 进化引擎配置
#[derive(Debug, Clone)]
pub struct EvolutionConfig {
/// 经验复用次数达到此阈值触发 L2
pub min_reuse_for_skill: u32,
/// 置信度阈值
pub quality_confidence_threshold: f32,
/// 是否启用进化引擎
pub enabled: bool,
}
impl Default for EvolutionConfig {
fn default() -> Self {
Self {
min_reuse_for_skill: 3,
quality_confidence_threshold: 0.7,
enabled: true,
}
}
}
/// 进化引擎中枢
pub struct EvolutionEngine {
viking: Arc<VikingAdapter>,
config: EvolutionConfig,
}
impl EvolutionEngine {
pub fn new(viking: Arc<VikingAdapter>) -> Self {
Self {
viking,
config: EvolutionConfig::default(),
}
}
/// Backward-compatible constructor
pub fn from_experience_store(_experience_store: Arc<ExperienceStore>) -> Self {
// Extract viking from ExperienceStore — we need the underlying adapter
// Since ExperienceStore holds Arc<VikingAdapter>, we create a new in-memory one
// For proper usage, use new() with the correct viking adapter
Self {
viking: Arc::new(VikingAdapter::in_memory()),
config: EvolutionConfig::default(),
}
}
pub fn with_config(mut self, config: EvolutionConfig) -> Self {
self.config = config;
self
}
pub fn set_enabled(&mut self, enabled: bool) {
self.config.enabled = enabled;
}
/// L2 检查:是否有可进化的模式
pub async fn check_evolvable_patterns(
&self,
agent_id: &str,
) -> Result<Vec<AggregatedPattern>> {
if !self.config.enabled {
return Ok(Vec::new());
}
let store = ExperienceStore::new(self.viking.clone());
let aggregator = PatternAggregator::new(store);
aggregator
.find_evolvable_patterns(agent_id, self.config.min_reuse_for_skill)
.await
}
/// L2 执行:为给定模式构建技能生成 prompt
/// 返回 (prompt_string, pattern) 供上层通过 LLM 调用后 parse
pub fn build_skill_prompt(&self, pattern: &AggregatedPattern) -> String {
SkillGenerator::build_prompt(pattern)
}
/// L2 执行:解析 LLM 返回的技能 JSON 并进行质量门控
pub fn validate_skill_candidate(
&self,
json_str: &str,
pattern: &AggregatedPattern,
existing_triggers: Vec<String>,
) -> Result<(SkillCandidate, QualityReport)> {
let candidate = SkillGenerator::parse_response(json_str, pattern)?;
let gate = QualityGate::new(self.config.quality_confidence_threshold, existing_triggers);
let report = gate.validate_skill(&candidate);
Ok((candidate, report))
}
/// 获取当前配置
pub fn config(&self) -> &EvolutionConfig {
&self.config
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::experience_store::Experience;
#[tokio::test]
async fn test_disabled_returns_empty() {
let viking = Arc::new(crate::VikingAdapter::in_memory());
let mut engine = EvolutionEngine::new(viking);
engine.set_enabled(false);
let patterns = engine.check_evolvable_patterns("agent-1").await.unwrap();
assert!(patterns.is_empty());
}
#[tokio::test]
async fn test_no_evolvable_patterns() {
let viking = Arc::new(crate::VikingAdapter::in_memory());
let engine = EvolutionEngine::new(viking);
let patterns = engine.check_evolvable_patterns("unknown-agent").await.unwrap();
assert!(patterns.is_empty());
}
#[tokio::test]
async fn test_finds_evolvable_pattern() {
let viking = Arc::new(crate::VikingAdapter::in_memory());
let store_inner = ExperienceStore::new(viking.clone());
let mut exp = Experience::new(
"agent-1",
"report generation",
"researcher",
vec!["query db".into(), "format".into()],
"success",
);
exp.reuse_count = 5;
store_inner.store_experience(&exp).await.unwrap();
let engine = EvolutionEngine::new(viking);
let patterns = engine.check_evolvable_patterns("agent-1").await.unwrap();
assert_eq!(patterns.len(), 1);
assert_eq!(patterns[0].pain_pattern, "report generation");
}
#[test]
fn test_build_skill_prompt() {
let viking = Arc::new(crate::VikingAdapter::in_memory());
let engine = EvolutionEngine::new(viking);
let exp = Experience::new(
"a", "report", "researcher", vec!["step1".into()], "ok",
);
let pattern = AggregatedPattern {
pain_pattern: "report".to_string(),
experiences: vec![exp],
common_steps: vec!["step1".into()],
total_reuse: 5,
tools_used: vec!["researcher".into()],
industry_context: None,
};
let prompt = engine.build_skill_prompt(&pattern);
assert!(prompt.contains("report"));
}
#[test]
fn test_validate_skill_candidate() {
let viking = Arc::new(crate::VikingAdapter::in_memory());
let engine = EvolutionEngine::new(viking);
let exp = Experience::new(
"a", "report", "researcher", vec!["step1".into()], "ok",
);
let pattern = AggregatedPattern {
pain_pattern: "report".to_string(),
experiences: vec![exp],
common_steps: vec!["step1".into()],
total_reuse: 5,
tools_used: vec!["researcher".into()],
industry_context: None,
};
let json = r##"{"name":"报表技能","description":"生成报表","triggers":["报表","日报"],"tools":["researcher"],"body_markdown":"# 报表\n步骤","confidence":0.9}"##;
let (candidate, report) = engine
.validate_skill_candidate(json, &pattern, vec!["搜索".to_string()])
.unwrap();
assert_eq!(candidate.name, "报表技能");
assert!(report.passed);
}
}