# Multiple Review

基于 Claude Code subagent 并发能力的多模型并行代码审查工具。

## 概述

本项目包含 `super-review` Claude Code skill，可以同时启动多个 reviewer 进行代码审查：

- Claude Code (opus/sonnet/haiku)
- OpenAI Codex
- Google Gemini CLI

## V2 新特性

### 三阶段审查流程

| 阶段 | 名称 | 输出评分 | 说明 |
|------|------|---------|------|
| Phase 1 | 一致性审查 | `compliance_score` | 代码是否符合设计文档和开发计划 |
| Phase 2 | UI 一致性审查 | `ui_compliance_score` | UI 实现是否符合设计规范（可选） |
| Phase 3 | 探索性审查 | `quality_score` | 代码质量、安全、性能分析 |

### 固定文档路径

V2 自动注入项目文档路径供 reviewer 参考：

```
docs/design/ui-spec.md    # UI 设计规范
docs/design/              # 设计文档目录
docs/plans/               # 开发计划目录
```

### 执行模式

- **confirm（默认）**：展示审查范围后等待用户确认
- **--skip-confirm**：跳过确认直接执行
- **--context "..."**：注入额外上下文信息

## Expert Review

多角色扮演审查工具，让 AI 扮演不同领域专家从多个视角审查同一内容。

### 特性

- 自动识别内容所属领域
- 选择 5 位顶级专家（多样性优先）
- 支持预设专家库 + AI 智能补充
- 并行审查，高效执行
- 汇总共识点与分歧点

### 使用

触发词：
- `expert-review`
- `专家审查`
- `多角色审查`

示例：
```bash
# 审查指定文件
expert-review prompts/my-prompt.md

# 跳过确认直接执行
专家审查 docs/design.md --skip-confirm

# 智能推断审查内容
多角色审查
```

### 配置

详见 `.reviews/experts.yaml.example`

### 输出

结果保存在 `.reviews/<content>_<timestamp>/` 目录：
- `review_*.md` - 各专家的独立报告
- `summary.md` - 汇总报告（共识、分歧、综合建议）
- `meta.json` - 元数据

## 安装

1. 将 skill 复制到 Claude Code skills 目录：

```bash
cp -r ~/.claude/skills/super-review ~/.claude/skills/
```

2. 复制示例配置到项目：

```bash
cp .reviews/config.yaml.example .reviews/config.yaml
```

3. 根据需要修改 `.reviews/config.yaml`

## 使用

触发词：
- `super-review`
- `超级审查`
- `并行审查`
- `全面 review`

示例：
```bash
# 审查指定文件
super-review src/main.py

# 审查 commits
超级审查最近三个 commit

# 智能推断审查内容
并行审查

# 跳过确认直接执行
super-review --skip-confirm

# 注入额外上下文
super-review --context "本次修改主要是用户登录功能"
```

## 配置

详见 `.reviews/config.yaml.example`

主要配置项：
- `default_mode`: 默认执行模式（confirm/skip-confirm）
- `default_template`: 默认模板（unified-review）
- `fixed_paths`: 固定文档路径
- `reviewers`: 启用的 reviewer 列表

## 输出

结果保存在 `.reviews/<content>_<timestamp>/` 目录：
- `review_*.md` - 各 reviewer 的审查结果
- `summary.md` - 汇总报告（包含三分评分）
- `meta.json` - 元数据和评分

### 输出示例

```
## 审查结果汇总

| Reviewer | 状态 | 耗时 | Compliance | UI Compliance | Quality |
|----------|------|------|------------|---------------|---------|
| claude-opus | ✅ | 45s | 8/10 | 7/10 | 7.5/10 |
| gemini | ✅ | 38s | 9/10 | N/A | 8/10 |

**平均分**
- compliance_score: 8.5/10
- ui_compliance_score: 7/10
- quality_score: 7.8/10
```

## 文档

- [V2 设计文档](docs/design/2025-12-28-super-review-v2-design.md)
- [V2 实现计划](docs/plans/2025-12-28-super-review-v2-impl.md)
- [原始设计文档](docs/plans/2025-12-28-super-review-design.md)
# super-review
# super-review