\r \r

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

\r

触发场景\r

\r 当用户请求以下任务时，自动激活此技能：\r

• 用户说"审核代码"、"检查代码修改"、"review代码"等关键词\r
• 用户要求验证AI修改是否符合需求\r
• 用户要求检查是否存在非必要文件修改\r
• 用户提供了需求描述和修改后的代码，要求对比验证\r \r

核心能力\r

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

1. 需求符合性检查\r

\r 执行逻辑：\r

1. 解析用户的原始需求描述，提取关键要点：\r
   • 功能性需求（要实现什么功能）\r
   • 技术约束（使用的框架、库、版本等）\r
   • 业务规则（业务逻辑要求）\r
   • 性能要求（如有）\r \r
2. 对比分析修改内容：\r
   • 检查每个修改点是否直接服务于需求\r
   • 标记与需求无关的代码修改\r
   • 识别过度设计或不必要的复杂性\r \r
3. 输出符合性报告：\r
   • ✅ 符合需求：列出直接对应需求的修改\r
   • ⚠️ 部分相关：列出可能相关但非必需的修改\r
   • ❌ 无关修改：列出与需求无关的修改\r \r 检查清单模板：\r

## 需求符合性检查报告\r
\r
### 原始需求\r
{用户描述的需求}\r
\r
### 关键要点提取\r
- 功能点1: {描述}\r
- 功能点2: {描述}\r
- 技术约束: {描述}\r
\r
### 修改分析\r
| 修改文件 | 修改内容 | 符合性 | 说明 |\r
|---------|---------|-------|------|\r
| {文件} | {简述} | ✅/⚠️/❌ | {原因} |\r
\r
### 总体评估\r
- 符合度评分: X/10\r
- 建议: {改进建议}\r
```\r
\r
### 2. 非必要文件修改检查\r
\r
**执行逻辑：**\r
1. 获取本次修改涉及的文件列表（通过git diff或用户提供）\r
2. 对每个文件进行必要性评估：\r
   - 是否为需求直接涉及的模块\r
   - 是否为配置文件（检查是否有必要改动）\r
   - 是否为测试文件（检查是否合理）\r
   - 是否为文档文件（检查是否相关）\r
\r
3. 识别风险修改：\r
   - 修改了不相关的核心文件\r
   - 大规模重构但需求很小\r
   - 修改了依赖版本配置\r
   - 修改了构建配置文件\r
\r
**警告级别：**\r
- 🔴 高风险：修改了与需求无关的核心业务文件\r
- 🟡 中风险：修改了配置文件或依赖\r
- 🟢 低风险：仅修改相关文件\r
\r
**检查报告模板：**\r
```markdown\r
## 非必要修改检查报告\r
\r
### 修改文件统计\r
- 总修改文件数: X\r
- 必要修改: X 个文件\r
- 可疑修改: X 个文件\r
- 不必要修改: X 个文件\r
\r
### 详细分析\r
\r
#### ✅ 必要修改\r
{文件列表及原因}\r
\r
#### ⚠️ 可疑修改\r
{文件列表及风险说明}\r
\r
#### ❌ 不必要修改\r
{文件列表及建议处理方式}\r
\r
### 风险评估\r
- 风险等级: 🔴/🟡/🟢\r
- 建议: {具体建议}\r
```\r
\r
### 3. 代码质量检查\r
\r
**检查项：**\r
- 代码风格一致性\r
- 是否存在硬编码\r
- 是否有足够的注释\r
- 变量命名规范性\r
- 潜在的性能问题\r
- 安全漏洞风险\r
\r
### 4. 变更影响分析\r
\r
**分析内容：**\r
- 修改的影响范围\r
- 是否会影响现有功能\r
- 是否需要数据库迁移\r
- 是否需要配置更新\r
\r
## 执行流程\r
\r
```\r
用户请求审核\r
    ↓\r
解析需求描述\r
    ↓\r
获取代码变更信息\r
    ↓\r
┌─────────────┬─────────────┬─────────────┐\r
│ 需求符合性  │ 非必要修改  │ 代码质量    │\r
│   检查      │    检查     │   检查      │\r
└─────────────┴─────────────┴─────────────┘\r
    ↓\r
生成综合审核报告\r
    ↓\r
提供改进建议\r
```\r
\r
## 使用示例\r
\r
### 示例1：基本使用\r
\r
**用户输入：**\r
```\r
审核一下这段代码修改是否符合需求。\r
\r
需求：添加用户登录功能，要求：\r
1. 支持用户名密码登录\r
2. 登录成功后返回token\r
3. 记录登录日志\r
\r
修改的文件：\r
- src/auth/login.ts\r
- src/models/user.ts\r
- package.json\r
- tsconfig.json\r
```\r
\r
**小龙虾响应：**\r
将按照检查流程，分析每个文件修改的必要性，输出详细的审核报告。\r
\r
### 示例2：Git变更审核\r
\r
**用户输入：**\r
```\r
帮我review一下最近的git commit，检查是否有不必要的修改\r
```\r
\r
**小龙虾响应：**\r
将执行 `git diff` 或 `git show` 获取变更，然后进行审核分析。\r
\r
## 异常处理\r
\r
1. **无法获取变更信息**\r
   - 提示用户提供变更文件列表或diff内容\r
   - 指导用户使用git命令获取变更\r
\r
2. **需求描述不清晰**\r
   - 引导用户补充需求细节\r
   - 基于代码变更反推可能的意图并确认\r
\r
3. **文件无法访问**\r
   - 提示用户确认文件路径\r
   - 建议用户提供文件内容\r
\r
## 配置选项\r
\r
用户可通过以下方式自定义审核行为：\r
\r
```yaml\r
# .claw/review-config.yaml\r
review:\r
  strictness: normal  # strict | normal | loose\r
  focus_areas:\r
    - requirement_alignment\r
    - unnecessary_changes\r
    - code_quality\r
  ignore_patterns:\r
    - "*.test.ts"\r
    - "*.spec.js"\r
  custom_rules:\r
    - "不允许修改.env文件"\r
    - "配置文件修改需要确认"\r
```\r
\r
## 输出格式\r
\r
审核报告支持多种格式：\r
- **Markdown**（默认）：适合在聊天中展示\r
- **JSON**：适合程序处理\r
- **HTML**：适合生成报告页面\r
\r
## 技能依赖\r
\r
- OpenClaw核心能力（文件读写、命令执行）\r
- Git工具（用于获取代码变更）\r
- 代码分析能力（AST解析等）\r
\r
## 更新日志\r
\r
### v1.0.0 (2026-03-11)\r
- 初始版本发布\r
- 支持需求符合性检查\r
- 支持非必要修改检测\r
- 支持代码质量基础检查\r
\r
## 反馈与贡献\r
\r
如有问题或建议，请访问：https://github.com/openclaw/easy-code-review/issues\r