skill-evolver

# Skill Evolver

自动分析和优化 OpenClaw Agent Skills 的 Python CLI 工具。

## 功能特性

- 📊 **使用监控**: 记录技能调用次数、成功率、响应时间
- 🏥 **健康度评估**: 基于可靠性、性能、代码质量、用户满意度的综合评分
- 🔍 **代码分析**: 检查 SKILL.md 完整性、Python 语法、代码质量问题
- 💡 **改进建议**: 基于规则自动生成优化建议
- 📈 **报告生成**: 支持 JSON、Markdown、HTML 格式导出

## 安装

```bash
# 使用 clawhub 安装
clawhub install skill-evolver

# 或手动安装
cd ~/.openclaw/skills/skill-evolver
pip install -r requirements.txt
```

## 依赖

- Python 3.8+
- SQLite3 (内置)
- PyYAML
- GitPython (可选，用于 Git 操作)

## 使用方法

### CLI 命令

```bash
# 初始化数据库
skill-evolver init

# 分析单个技能
skill-evolver analyze <skill-name>

# 分析所有技能
skill-evolver analyze --all

# 查看详细分析
skill-evolver analyze <skill-name> --verbose

# 生成健康度报告
skill-evolver report <skill-name>

# 生成所有技能报告
skill-evolver report --all

# 导出报告
skill-evolver report <skill-name> -o report.json -f json
skill-evolver report <skill-name> -o report.md -f markdown
skill-evolver report <skill-name> -o report.html -f html

# 查看健康度评分
skill-evolver health <skill-name>
skill-evolver health --all

# 记录技能使用
skill-evolver log <skill-name> <action> --status success --duration 100

# 添加用户反馈
skill-evolver feedback <skill-name> 5 --comment "很好用"

# 清理旧数据
skill-evolver clear --days 90

# 列出已记录的技能
skill-evolver log --list
```

### Python API

```python
from skill_evolver import SkillMonitor, SkillAnalyzer, SkillReporter

# 监控技能使用
monitor = SkillMonitor()

# 方式 1: 手动记录
monitor.log_usage(
    skill_name="my-skill",
    action="process",
    status="success",
    duration_ms=150
)

# 方式 2: 使用上下文管理器
with monitor.track("my-skill", "process") as tracker:
    result = do_something()
    tracker.set_context({"input_size": len(data)})

# 方式 3: 使用装饰器
@monitor.track_decorator("my-skill")
def my_function():
    pass

# 分析技能代码
analyzer...

# Skill Evolver

自动分析和优化 OpenClaw Agent Skills 的 Python CLI 工具。

## 🎯 功能概述

Skill Evolver 帮助你：

- 📊 **监控技能使用情况** - 追踪调用次数、成功率、响应时间
- 🏥 **评估健康度** - 综合评分系统，快速识别问题技能
- 🔍 **分析代码质量** - 检查 SKILL.md 完整性、语法错误、代码规范
- 💡 **生成改进建议** - 基于规则自动提供优化方案
- 📈 **导出报告** - 支持 JSON、Markdown、HTML 格式

## 🚀 快速开始

### 安装

```bash
# 使用 clawhub 安装（推荐）
clawhub install skill-evolver

# 或手动克隆
git clone https://github.com/openclaw/skills/skill-evolver.git
cd skill-evolver
pip install -r requirements.txt
```

### 初始化

```bash
# 初始化数据库
skill-evolver init
```

### 基本使用

```bash
# 分析技能
skill-evolver analyze my-skill

# 生成健康度报告
skill-evolver report my-skill

# 查看所有技能健康度
skill-evolver health --all
```

## 📖 详细文档

完整使用说明请查看 [SKILL.md](./SKILL.md)

## 🛠️ 开发

### 环境要求

- Python 3.8+
- SQLite3 (内置)

### 安装依赖

```bash
pip install pyyaml gitpython pytest flake8
```

### 运行测试

```bash
python -m pytest tests/ -v
```

### 代码检查

```bash
python -m flake8 skill_evolver/ database/
```

## 📁 项目结构

```
skill-evolver/
├── SKILL.md              # 技能说明文档
├── package.json          # 包元数据
├── README.md             # 项目说明
├── skill_evolver/        # 主模块
│   ├── __init__.py       # 模块入口
│   ├── monitor.py        # 使用监控
│   ├── analyzer.py       # 代码分析
│   ├── reporter.py       # 报告生成
│   └── cli.py            # CLI 入口
├── database/
│   ├── __init__.py       # 数据库模块
│   └── models.py         # 数据模型
└── tests/                # 测试用例
    ├── test_database.py
    ├── test_analyzer.py
    ├── test_reporter.py
    └── test_cli.py
```

## 📊 健康度评分

综合评分由以下维度计算：

| 维度 | 权重 | 说明 |
|------|------|------|
| 可靠性 | 30% | 基于成功率 |
| 性能 | 20% | 基于响应时间 |
| 代码质量 | 30% | 基于代码分析 |
| 用户满意度 | 20% | 基于用户反馈 |

### 状态等级

- 🟢 **healthy**...