Version 2.0.0 · Phase 1-3 全部完成 · 2026-08-16
复盘-经验沉淀固化 (reflection-compound) v2.0
> Phase 1-3 全部完成 · 2026-08-16
模块架构
reflection-compound/
├── SKILL.md ← 本文件
├── scripts/
│ ├── __main__.py ← CLI统一入口
│ ├── log_lesson.py ← 写入教训（桥接 self-improving-compound）
│ ├── capture_gate.py ← 9项捕获门控
│ ├── adl_check.py ← ADL一致性检查
│ ├── promote.py ← VFM晋升机制
│ ├── extract.py ← 技能提取流水线
│ ├── logger_op.py ← JSONL操作日志
│ ├── learnings.py ← FTS5检索（含fts5_escape）
│ └── run_evals.py ← 测试套件入口
└── evals/
├── test_reflection_gate.py 14项
├── test_lesson_retrieval.py 11项
└── test_promotion.py 10项
CLI 命令
# 写入教训
python -m reflection_compound log --type learning --summary "..." --pattern "exec:xxx" --area "domain:xxx" --next-action "..."
# 检索
python -m reflection_compound search "关键词" --type error --limit 10
python -m reflection_compound stats
# 晋升
python -m reflection_compound promote --threshold 0.5 --dry-run
# 提取
python -m reflection_compound extract --extract-threshold 2.5 --dry-run
# ADL检查
python -m reflection_compound adl --fix
# 测试
python -m reflection_compound evals --verbose
核心参数
| 参数 | 值 | 说明 |
|---|---|---|
| 晋升阈值 | 0.5 | 单 pattern 匹配即晋升 |
| 提取阈值 | 2.5 | 高分教训触发技能提取 |
| Nudge Cron | 每日 21:00 | cron ID: f8beb3e8 |
| JSONL日志 | logs/reflection_compound_audit.jsonl | 操作审计 |
| review_needed列 | lessons_v2 | ADL冲突标记 |
捕获门控 9项
- 先生纠正（事实/偏好/工作流/预期）
- 错误/工具怪癖/格式不匹配
- workaround/环境约定才成功
- 重复出现或能改变未来行为
- 发现比现有方案更高效的做法
- 先生请求系统当前不具备的能力
- 复杂任务（≥5步）完成且结果满意
- 修复bug或绕过限制
- 学到新的外部知识
质量门
- 每条记录必须含
--next-action（下次如何预防） - Pattern-Key 必须带命名空间（
project:key/domain:key/tool:key） - 禁止记录隐私/密钥信息
- FTS5 检索 pattern 值含
:时用短语语法：pattern:"exec:python"
更新检查
联网比对本地版本与 SkillHub 已发布版本：
python3 scripts/update_check.py
退出码 10 = 有新版本可用，0 = 已最新。
