skill-assessment

## 概述
**skill-assessment** 是一个轻量级静态分析工具，用于评估 OpenClaw 技能的质量。它不执行任何代码，仅通过文件分析和元数据检查，从**文档完整性**、**代码规范性**、**配置友好度**、**维护活跃度**四个维度对技能进行评分，帮助用户快速筛选技能，为开发者提供改进方向。

## 触发场景
- 当你想了解某个技能的可靠性和质量时
- 当你在多个相似技能间犹豫不决时  
- 当你开发完技能，想检查潜在问题和改进点时
- 当你需要批量评估所有本地技能，找出薄弱环节时

## 安装
```bash
# 方法1：从 ClawHub 安装（发布后）
clawhub install skill-assessment

# 方法2：本地安装（开发阶段）
cd /path/to/skill-assessment
ln -sf $(pwd) ~/.openclaw/skills/skill-assessment
```

## 使用方式

### 基本用法
```bash
# 评估单个技能
skill-assess ~/.openclaw/skills/skill-creator

# 评估当前目录下的技能
skill-assess .

# 批量评估所有本地技能
skill-assess --all

# 评估并生成JSON格式报告
skill-assess ~/.openclaw/skills/skill-creator --format json

# 仅显示问题清单
skill-assess ~/.openclaw/skills/skill-creator --problems-only

# 对比两个技能
skill-assess --compare skill-creator skill-audit
```

### 输出示例
```
🔍 技能评估报告：skill-creator
📊 综合评分：★★★★☆ (4.2/5)
⏱️ 评估用时：12秒
📁 技能路径：~/.openclaw/skills/skill-creator

维度得分：
  文档完整性：★★★★☆ (4.0/5)
  代码规范性：★★★★★ (4.5/5)
  配置友好度：★★★☆☆ (3.5/5)
  维护活跃度：★★★★☆ (4.0/5)

⚠️ 发现问题：3个
✅ 通过检查：21个
📋 详细报告：~/.openclaw/skills/skill-assessment/reports/skill-creator_2026-03-12.md
```

## 评估维度

### 1. 文档完整性 (权重30%)
- **SKILL.md 存在性**：强制检查，缺失则直接0分
- **必填章节**：name, description, triggers, usage, installation, configuration
- **示例质量**：示例是否可复制，是否有输入输出说明
- **配置说明**：默认配置示例，环境变量支持

### 2. 代码规范性 (权重40%)
- **文件结构**：清晰的目录组织（scripts/, templates/, examples/）
- **安全风险**：硬编码密钥、危险权限、注入漏洞
- **错误处理**：`set -e` 或 `try/catch`，友好的错误提示
- **工具使用**：权限申请合理性，安全边界

### 3. 配置友好度 (权重20%)
- **默认配置**：合理的默认值...