Klacb/claude-self-improve

# Claude 自我改进插件 基于 Hermes Agent 的自我改进机制，为 Claude Code 打造的自动学习和改进系统。 ## 核心功能 | 功能 | 说明 | |------|------| | **Session 评分** | 每次 session 结束自动评分（错误率、重试率、人工修正） | | **模式检测** | 检测重复模式，3 次以上自动 promote 为规则 | | **Skill 自动创建** | 复杂任务后自动创建可复用 skill | | **Memory 提升** | MEMORY.md → CLAUDE.md 规则自动提升 | | **效果追踪** | 追踪每个改进的效果，无效自动回滚 | | **仪表盘** | `/improve` 命令查看改进状态 | ## 安装 ``` # 复制到你的项目 cp -r claude-self-improve/ /path/to/your/project/.claude/ # 或者全局安装 cp -r claude-self-improve/ ~/.claude/ # 运行测试 python test.py ``` ## 使用 ### 自动模式（推荐） 安装后自动运行，每次 session 结束会： 1. 分析 transcript（JSONL） 2. 评分 0-100 3. 提取 pattern 4. 检查是否值得创建 skill 5. 追踪规则效果 ### 手动命令 ``` /improve # 查看改进仪表盘 /improve review # 审查待promote的patterns /improve scores # 查看历史评分 /improve skills # 查看已创建的skills /improve effects # 查看规则效果追踪 /improve revert [rule_key] # 回滚指定规则 ``` ## 架构 ``` Session结束 ↓ Hook触发 → 解析JSONL transcript ↓ ┌─────────────────────────────────────────────────────────────┐ │ Step 1: 评分引擎 │ │ - 错误率 (30%) │ │ - 重试率 (20%) │ │ - 修正率 (30%) │ │ - 工具误用 (20%) │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ Step 2: 模式检测 │ │ - 高错误率 (>20%) │ │ - 频繁修正 (>=2次) │ │ - 重试过多 (>=3次) │ │ - 低分session (<60) │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ Step 3: 规则提升 │ │ - 3次以上重复 → 生成CLAUDE.md rule提案 │ │ - 用户审查 → /improve review │ │ - 批准 → 写入.claude/rules/ │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ Step 4: Skill创建 │ │ - 检测复杂任务 (>=5次工具调用 或 >=3种工具) │ │ - 自动生成skill文件 │ │ - 保存到 learnings/skills/ │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ Step 5: 效果追踪 │ │ - 追踪每条规则的使用情况 │ │ - 计算效果分数 (0-100) │ │ - 无效规则自动标记/回滚 │ └─────────────────────────────────────────────────────────────┘ ``` ## 文件结构 ``` .claude/ ├── self-improve/ │ ├── hooks/ │ │ └── session-end.sh # Session结束hook │ ├── commands/ │ │ └── improve.md # /improve命令文档 │ ├── scripts/ │ │ ├── score.py # 评分引擎 │ │ ├── detect.py # 模式检测 │ │ ├── promote.py # 规则提升 │ │ ├── skills.py # Skill自动创建 │ │ ├── effectiveness.py # 效果追踪 │ │ └── dashboard.py # 仪表盘执行脚本 │ ├── learnings/ # 学习记录 │ │ ├── patterns.json # 检测到的模式 │ │ ├── scores.json # 历史评分 │ │ ├── effectiveness.json # 效果追踪数据 │ │ └── skills/ # 自动创建的skills │ └── config.json # 配置 └── rules/ └── auto-generated.md # 自动生成的规则 ``` ## 配置 `.claude/self-improve/config.json`: ``` { "auto_promote": false, "min_occurrences": 3, "rules_file": "auto-generated.md", "revert_after_sessions": 10, "min_effectiveness_score": 30, "auto_revert": false, "score_weights": { "error_rate": 0.3, "retry_rate": 0.2, "correction_rate": 0.3, "tool_misuse": 0.2 }, "skill_threshold": 5, "patterns": { "high_error_rate": { "enabled": true, "threshold": 0.2, "description": "工具调用错误率超过20%" }, "frequent_corrections": { "enabled": true, "threshold": 2, "description": "用户修正次数>=2" }, "excessive_retries": { "enabled": true, "threshold": 3, "description": "重试次数>=3" }, "low_score_session": { "enabled": true, "threshold": 60, "description": "Session评分低于60" } }, "dashboard": { "show_recent_scores": 10, "show_patterns": true, "show_skills": true, "show_effectiveness": true } } ``` ### 配置说明 | 参数 | 说明 | 默认值 | |------|------|--------| | `auto_promote` | 自动 promote 规则（不推荐） | `false` | | `min_occurrences` | promote 所需的最小出现次数 | `3` | | `revert_after_sessions` | 追踪多少个 session 后判断规则是否有效 | `10` | | `min_effectiveness_score` | 最低效果分数（低于此值标记为无效） | `30` | | `auto_revert` | 自动回滚无效规则 | `false` | | `skill_threshold` | 创建 skill 所需的最小工具调用次数 | `5` | ## 仪表盘示例 ``` 📊 Self-Improving Dashboard ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Recent Scores: 2026-01-15: 78.0/100 ████████░░ 2026-01-14: 82.0/100 █████████░ 2026-01-13: 65.0/100 ██████░░░░ 2026-01-12: 91.0/100 █████████░ 2026-01-11: 73.0/100 ███████░░░ Rolling Average: 75.0/100 Patterns Detected: 12 ├─ Promoted: 5 ├─ Pending: 6 └─ Rejected: 1 Skills Created: 3 ├─ git-workflow ├─ api-testing └─ error-handling Rules Tracked: 5 ├─ Effective: 2 ├─ Ineffective: 1 └─ Tracking: 2 Run /improve review to see pending patterns. ``` ## 与 Hermes 的对比 | 功能 | Hermes | Claude 版 | |------|--------|----------| | Skill 创建 | ✅ 自动 | ✅ 自动 | | Memory 三层 | ✅ 内置 | ✅ CLAUDE.md + MEMORY.md + learnings/ | | Curator | ✅ 后台进程 | ⚠️ 手动/improve review | | Session 搜索 | ✅ FTS5 | ⚠️ 基础 grep | | 效果追踪 | ✅ 内置 | ✅ effectiveness.json | | 自动回滚 | ✅ 内置 | ✅ auto_revert 配置 | ## 开发 ``` # 运行测试 python test.py # 手动运行各模块 python scripts/score.py python scripts/detect.py python scripts/promote.py python scripts/skills.py python scripts/effectiveness.py [config_file] python scripts/dashboard.py [self_improve_dir] ``` ## License MIT

标签：AI开发工具, AI智能体, Claude Code, Cutter, 时序数据库, 自动化流程, 自学习机制, 逆向工具