cmdc_skill_engine Changelog

Copy Markdown View Source

本项目遵循 Semantic Versioning 与 Keep a Changelog 规范。

[0.2.1] - 2026-05-16

Compatibility patch — 让 cmdc_skill_engine 与 cmdc 0.4 主线生态 对齐，并补 Phase 11E benchmark 工具链（v0.2.0 后 commit 但未发布）。

Changed — cmdc 依赖范围升级

  • {:cmdc, "~> 0.2"} → {:cmdc, "~> 0.4"}
    • 背景：~> 0.2 严格语义 >= 0.2.0 and < 0.3.0 阻塞与 cmdc 0.3/0.4 共存。用户同时引入 cmdc 0.4 + cmdc_skill_engine 0.2 会 触发 Hex 版本冲突
    • 兼容性核实：本库依赖的 cmdc 抽象（CMDC.Plugin behaviour + CMDC.SystemPrompt Skills 注入接口）都在 v0.1 起稳定，且 v0.2-v0.4 无 breaking change（除 v0.3 #B21 facade tuple，本库不调 facade）
    • 无运行时行为变更

Added — Benchmark 工具链（Phase 11E.18 补发）

  • 新增 benchmark/quality_update.exs — 100 skills × 10 轮 quality_update 传播 Benchee suite（Store + QualityTracker 热路径性能基线）
  • benchmark/README.md — benchmark 运行指引
  • :benchee, ~> 1.3 加入 dev / test 依赖

Migration

  • 老用户仍用 cmdc 0.2 → 锁 {:cmdc_skill_engine, "0.2.0"} 即可
  • 想用 cmdc 0.4 → 升级到 {:cmdc_skill_engine, "~> 0.2.1"}

[0.2.0] - 2026-04-25

真实自进化闭环 —— 对齐 Agentic Design Patterns 第 9 章 (Learning and Adaptation) 与 OpenSpace SkillEvolver。

Added

  • CMDCSkillEngine.Store.Backend behaviour — 存储后端抽象层，定义 init/1 / get_record/2 / save_record/2 / list_all/1 / update_counters/3 / reset/1 / terminate/1 契约。
  • CMDCSkillEngine.Store.Backend.ETS — v0.1 的默认后端，单节点开发/测试首选。
  • CMDCSkillEngine.Store.Backend.SQLite — 基于 exqlite 的持久化后端，自动 创建 schema + 索引，支持 JSON 字段序列化（lineage / recent_analyses / tags）。
  • CMDCSkillEngine.Analyzer.LLM — ReqLLM generate_object/4 驱动的结构化 分析器；强制输出 task_completed / execution_note / tool_issues / skill_judgments / evolution_suggestions；自带超时控制与 :generate_fn 注入钩子便于离线测试。
  • CMDCSkillEngine.SkillRanker.Semantic — 新的 Selector 实现，结合 BM25 关键词相关性、effective_rate 质量反馈与可选 ReqLLM.embed/3 语义向量 相似度（:embedding_model 未配置时自动退化为 BM25 + 质量加权）。
  • CMDCSkillEngine.QualityTracker.should_deactivate?/2 + update_from_analysis/3 — 新增自动停用规则：达到 min_samples 后，若 applied_rate < applied_min 或 effective_rate < effective_min 且 trend != :improving，自动把 is_active = false。
  • CMDCSkillEngine.Evolver fix 链长度上限（默认 5）；超过时返回 {:error, {:fix_chain_too_long, generation, max_depth}}，防止进化链 失控膨胀。
  • example/skill_evolution_demo.exs — 10 轮会话的完整自进化演示，无 LLM 依赖，可 mix run 复现。
  • test/cmdc_skill_engine/stress_test.exs — 1000 轮收敛压力测试，验证 QualityTracker 能在合理轮次内识别并停用低质量 Skill。

Changed

  • CMDCSkillEngine.Store 重构为委托结构：GenServer state 保存 {backend_module, backend_state}，所有 CRUD 操作通过 Backend 契约转发； 公共 API 完全向后兼容。
  • CMDCSkillEngine.Analyzer 集成 LLM 路径：当 analysis_model 是 LLM spec（非 nil / "builtin" / "manual" / "rule" / ""）时，:session_end 走 LLM 分析；任何失败（超时 / HTTP / schema / 异常）自动降级到规则分析， 不打断 Agent 正常结束流程。
  • CMDCSkillEngine.Analyzer state 新增 :messages 字段，累积 :before_prompt / :after_response 消息，作为 LLM 分析上下文。
  • CMDCSkillEngine.QualityTracker.update_from_analysis/2 改为三元参数版本 update_from_analysis/3（第三参数可选 keyword()），保持对现有调用方 向后兼容。
  • Application.start/2 支持 :start_store 配置开关，测试环境默认关闭 自动启动以避免与 ExUnit 测试隔离冲突。

Fixed

  • Store GenServer 初始化时默认启动逻辑与测试隔离机制冲突，导致多个测试 互相竞争同一 ETS 表 —— 现通过 start_store: false（test 环境）+ test_helper.exs 里的单次 start_link + Process.unlink/1 修复。

Deps

  • 新增 {:exqlite, "~> 0.27"}、{:jason, "~> 1.4"}（SQLite backend
    • JSON 序列化）

测试覆盖

  • 105 个测试全部通过（3 个 @moduletag :stress 压力测试默认排除）
  • Store Backend 契约共 32 个测试（ETS × 16 + SQLite × 16）
  • Analyzer.LLM 10 个单元测试（全部通过 :generate_fn stub，无真实 LLM）
  • Analyzer 集成 15 个测试（LLM 命中 + 失败降级 + 规则关键字保护）
  • SkillRanker.Semantic 9 个测试（BM25 / 质量回退 / embedding 注入）
  • QualityTracker 15 个测试（计数器 + trend + deactivation 门控）
  • Evolver 10 个测试（FIX / DERIVED / CAPTURED + fix chain 上限）

[0.1.0] - 2026-04-23

Added

  • 初始版本：ETS Store、规则 Analyzer、QualityTracker、Evolver (FIX/DERIVED/CAPTURED)、SkillRanker（按 effective_rate 排序）。
  • 对标 OpenSpace SkillEvolver 的完整数据模型（SkillRecord / SkillLineage / ExecutionAnalysis / SkillJudgment / EvolutionSuggestion）。