# x-rw-skill-improver

**Repository Path**: riverwit/x-rw-skill-improver

## Basic Information

- **Project Name**: x-rw-skill-improver
- **Description**: Skill质量管家——评估、验证、改造一体化工具。 触发场景：改造skill、评估skill质量、验证skill升级、回归测试、skill健康检查。 核心能力：darwin 8维静态评估、4维动态验证、回归集管理、 改造方案生成与执行、趋势追踪、定期健康检查。
核心哲学：如何帮别人变得更好
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-14
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Skill 质量管家 — x-rw-skill-improver

> 🎯 Skills生态的SonarQube — 为AI Skill提供静态审查、动态验证、行为分析和自进化能力

评估、验证、改造、审查 Skill 的一体化工具。

**版本**: v2.8.0 | **最后更新**: 2026-05-19  
**作者**: rw | **邮箱**: bigmouthz@163.com

> 📖 **本文档面向用户**：安装说明、使用示例、典型场景指南  
> 🤖 **AI参考文档**：`SKILL.md`（智能体执行规范）、`references/`（技术细节）

---

## 一、如何使用

### 方式一：对话式使用（推荐）

直接在 AI 对话中描述你想做什么：

```
你：帮我审查一下 x-rw-kb-build 这个skill的文档结构

AI：正在按 SKILL.md/README.md 编写规约进行审查...
    检查项 S1-S6（SKILL.md）+ R1-R4（README.md）
    发现5个问题，已生成 temp/x-rw-kb-build/TODO.md
    是否开始按TODO执行修复？
```

### 方式二：命令式使用

明确指定模式和目标Skill：

| 模式 | 示例 |
|------|------|
| M1: 完整改造 | "改造 x-rw-kb-build" |
| M2: 仅评估 | "评估 x-rw-kb-audit 的质量" |
| M3: 升级后验证 | "验证 x-rw-kb-study 升级后有没有退化" |
| M4: 定期健康检查 | "检查所有skill的健康状态" |
| M5: 回归集构建 | "为 x-rw-kb-apply 构建回归测试集" |
| M6: 结构审查 | "审查 x-rw-kb-build 的文档结构" |

### 方式三：脚本化使用（高级）

```bash
# 变更检测
python3 scripts/change_detector.py /path/to/skill HEAD~1

# 执行回归
python3 scripts/regression_runner.py /path/to/skill --save

# 生成报告
python3 scripts/report_generator.py data.json --output report.md
```

---

## 二、M6: 结构审查完整示例

### 示例：审查 x-rw-kb-build 的文档结构

**步骤1：启动审查**
```
你：审查 x-rw-kb-build 的 SKILL.md 和 README.md 结构
```

**步骤2：查看审查结果**
```
AI：🔍 审查完成！结果如下：

SKILL.md 检查：
  ✅ S1: 标题与name一致
  ⚠️ S2: 行数 429行（超过200行目标）
  ❌ S3: 命令速查表引用README.md
  ...

README.md 检查：
  ❌ R1: 缺少"如何使用"章节
  ❌ R2: 缺少完整使用示例
  ...

已生成 temp/x-rw-kb-build/TODO.md，共5项待修复任务。
是否开始按TODO执行修复？
```

**步骤3：确认修复**
```
你：是的，开始修复

AI：正在逐项修复...
    ✅ S2: SKILL.md 已精简至148行
    ✅ S3: 命令速查表已移除README.md引用
    ✅ R1: README.md 已添加"如何使用"章节
    ✅ R2: README.md 已添加完整使用示例
    ✅ R4: README.md 已添加安装说明

修复完成！所有检查项通过 ✅
```

---

## 三、七大模式速查

| 模式 | 用途 | 适合场景 | 产出 |
|------|------|---------|------|
| **M1: 完整改造** | 全面质量提升 | Skill质量明显不足 | 评估报告 + 改造方案 + 结果验证 |
| **M2: 仅评估** | 了解当前质量 | 初次使用、新接手Skill | darwin + verifier 两份报告 |
| **M3: 升级后验证** | 确认无退化 | Skill版本更新后 | 验证报告 + 趋势对比 |
| **M4: 定期健康检查** | 批量体检 | 每周/每月巡检 | 健康汇总报告 |
| **M5: 回归集构建** | 建立测试基线 | 新Skill或回归集过期 | regression.json |
| **M6: 结构审查** | 文档规范化 | 确保SKILL.md/README.md符合规约 | 审查报告 + TODO清单 |

---

## 四、安装 Skill

### 前置条件

- SOLO 或其他支持 Skill 机制的 AI 工具
- Python 3.8+
- pip 依赖：无额外依赖（核心评估由AI完成）

### 安装步骤

1. 将 `x-rw-skill-improver` 目录放置于 skills 目录中
2. 确认 `SKILL.md`、`references/`、`scripts/` 存在
3. 在对话中提及触发词即可激活

---

## 五、常见问题

**Q: M6 和 M2 有什么区别？**
A: M2 评估Skill的功能质量（能否正确执行任务），M6 审查文档结构（SKILL.md和README.md是否规范）。

**Q: temp/TODO.md 在哪？**
A: 在 `x-rw-skill-improver/temp/{skill-name}/TODO.md`，每次M6审查都会生成对应的任务清单。

**Q: 可以只审查不修复吗？**
A: 可以。M6运行后会生成报告和TODO清单，用户可以选择稍后修复。