SkillHub

easy-code-review

v1.0.0

AI代码审核助手，自动审查AI修改的代码，检查是否符合原始需求、是否存在非必要修改

Sourced from ClawHub, Authored by yanghao-smile

Installation

Please help me install the skill `easy-code-review` from SkillHub official store. npx skills add yanghao-smile/easy-code-review

AI代码审核助手 (Code Review Assistant)

触发场景

当用户请求以下任务时，自动激活此技能： - 用户说"审核代码"、"检查代码修改"、"review代码"等关键词 - 用户要求验证AI修改是否符合需求 - 用户要求检查是否存在非必要文件修改 - 用户提供了需求描述和修改后的代码，要求对比验证

核心能力

本技能赋予小龙虾以下代码审核能力：

1. 需求符合性检查

执行逻辑： 1. 解析用户的原始需求描述，提取关键要点： - 功能性需求（要实现什么功能） - 技术约束（使用的框架、库、版本等） - 业务规则（业务逻辑要求） - 性能要求（如有）

  1. 对比分析修改内容：
  2. 检查每个修改点是否直接服务于需求
  3. 标记与需求无关的代码修改

  4. 识别过度设计或不必要的复杂性

  5. 输出符合性报告：

  6. ✅ 符合需求：列出直接对应需求的修改
  7. ⚠️ 部分相关：列出可能相关但非必需的修改
  8. ❌ 无关修改：列出与需求无关的修改

检查清单模板：

## 需求符合性检查报告

### 原始需求
{用户描述的需求}

### 关键要点提取
- 功能点1: {描述}
- 功能点2: {描述}
- 技术约束: {描述}

### 修改分析
| 修改文件 | 修改内容 | 符合性 | 说明 |
|---------|---------|-------|------|
| {文件} | {简述} | ✅/⚠️/❌ | {原因} |

### 总体评估
- 符合度评分: X/10
- 建议: {改进建议}

2. 非必要文件修改检查

执行逻辑： 1. 获取本次修改涉及的文件列表（通过git diff或用户提供） 2. 对每个文件进行必要性评估： - 是否为需求直接涉及的模块 - 是否为配置文件（检查是否有必要改动） - 是否为测试文件（检查是否合理） - 是否为文档文件（检查是否相关）

  1. 识别风险修改：
  2. 修改了不相关的核心文件
  3. 大规模重构但需求很小
  4. 修改了依赖版本配置
  5. 修改了构建配置文件

警告级别： - 🔴 高风险：修改了与需求无关的核心业务文件 - 🟡 中风险：修改了配置文件或依赖 - 🟢 低风险：仅修改相关文件

检查报告模板：

## 非必要修改检查报告

### 修改文件统计
- 总修改文件数: X
- 必要修改: X 个文件
- 可疑修改: X 个文件
- 不必要修改: X 个文件

### 详细分析

#### ✅ 必要修改
{文件列表及原因}

#### ⚠️ 可疑修改
{文件列表及风险说明}

#### ❌ 不必要修改
{文件列表及建议处理方式}

### 风险评估
- 风险等级: 🔴/🟡/🟢
- 建议: {具体建议}

3. 代码质量检查

检查项： - 代码风格一致性 - 是否存在硬编码 - 是否有足够的注释 - 变量命名规范性 - 潜在的性能问题 - 安全漏洞风险

4. 变更影响分析

分析内容： - 修改的影响范围 - 是否会影响现有功能 - 是否需要数据库迁移 - 是否需要配置更新

执行流程

用户请求审核
    ↓
解析需求描述
    ↓
获取代码变更信息
    ↓
┌─────────────┬─────────────┬─────────────┐
│ 需求符合性  │ 非必要修改  │ 代码质量    │
│   检查      │    检查     │   检查      │
└─────────────┴─────────────┴─────────────┘
    ↓
生成综合审核报告
    ↓
提供改进建议

使用示例

示例1：基本使用

用户输入：

审核一下这段代码修改是否符合需求。

需求：添加用户登录功能，要求：
1. 支持用户名密码登录
2. 登录成功后返回token
3. 记录登录日志

修改的文件：
- src/auth/login.ts
- src/models/user.ts
- package.json
- tsconfig.json

小龙虾响应： 将按照检查流程，分析每个文件修改的必要性，输出详细的审核报告。

示例2：Git变更审核

用户输入：

帮我review一下最近的git commit，检查是否有不必要的修改

小龙虾响应： 将执行 git diff 或 git show 获取变更，然后进行审核分析。

异常处理

  1. 无法获取变更信息
  2. 提示用户提供变更文件列表或diff内容

  3. 指导用户使用git命令获取变更

  4. 需求描述不清晰

  5. 引导用户补充需求细节

  6. 基于代码变更反推可能的意图并确认

  7. 文件无法访问

  8. 提示用户确认文件路径
  9. 建议用户提供文件内容

配置选项

用户可通过以下方式自定义审核行为：

# .claw/review-config.yaml
review:
  strictness: normal  # strict | normal | loose
  focus_areas:
    - requirement_alignment
    - unnecessary_changes
    - code_quality
  ignore_patterns:
    - "*.test.ts"
    - "*.spec.js"
  custom_rules:
    - "不允许修改.env文件"
    - "配置文件修改需要确认"

输出格式

审核报告支持多种格式： - Markdown（默认）：适合在聊天中展示 - JSON：适合程序处理 - HTML：适合生成报告页面

技能依赖

  • OpenClaw核心能力（文件读写、命令执行）
  • Git工具（用于获取代码变更）
  • 代码分析能力（AST解析等）

更新日志

v1.0.0 (2026-03-11)

  • 初始版本发布
  • 支持需求符合性检查
  • 支持非必要修改检测
  • 支持代码质量基础检查

反馈与贡献

如有问题或建议，请访问：https://github.com/openclaw/easy-code-review/issues