| name | review-coderule |
| description | 代码规范评审。当用户需要检查代码是否符合编码规范、命名规范、代码格式,或询问"帮我做代码规范检查"、"评审这段代码"时使用。 |
代码规范评审
语言要求
所有输出内容必须使用中文,包括评审报告、问题描述、改进建议、总体评价等。
功能说明
根据指定的代码规范对代码进行评审,检查代码是否符合团队或项目的编码标准。
规范文件引用
进行代码规范评审时,参考以下规范文件:
使用方式
当用户提供代码规范文件路径和待评审代码时,执行规范检查并生成评审报告。
输入要求
代码规范文件(必需):
- 必须提供代码规范文件路径:
/projectdocs/sample/code_standard.md
- 用户可以根据
/projectdocs/sample/code_standard_template.md 模板编写自己的代码规范
- 代码规范应包含:
- 命名规范
- 代码格式规范
- 注释规范
- 设计原则
- 最佳实践
- 禁止事项
待评审代码:
评审流程
1. 读取代码规范
- 从
/projectdocs/sample/code_standard.md 读取项目的代码规范
- 如果文件不存在,提示用户先创建代码规范文件
- 解析规范中的检查项
2. 代码检查
- 按照代码规范逐项检查
- 记录所有不符合规范的地方
- 标注具体的位置(文件名、行号)
3. 生成报告
- 列出所有不符合规范的问题
- 提供改进建议和示例代码
- 给出符合性评分
问题等级
🔴 严重问题(Critical)
🟠 重要问题(Major)
🟡 一般问题(Normal)
🟢 建议优化(Minor)
评审报告格式
# 代码规范评审报告
## 概览
- 评审文件:xxx.java
- 评审时间:2024-xx-xx
- 代码行数:xxx 行
- 规范符合度:xx%
- 问题总数:xx 个
## 评审结果
### 🔴 严重问题(x 个)
1. **[文件名:行号] 问题标题**
- 规范项:...
- 问题描述:...
- 当前代码:
```java
// 现有代码
🟠 重要问题(x 个)
...
🟡 一般问题(x 个)
...
🟢 建议优化(x 个)
...
总体评价
- 规范符合度:xx%
- 主要优点:...
- 主要问题:...
- 改进建议:...
## 评审清单
### 命名规范
- [ ] 类名是否符合规范
- [ ] 方法名是否符合规范
- [ ] 变量名是否符合规范
- [ ] 常量名是否符合规范
### 代码格式
- [ ] 缩进是否符合规范
- [ ] 空行使用是否合理
- [ ] 括号位置是否符合规范
- [ ] 行长度是否符合限制
### 注释规范
- [ ] 类注释是否完整
- [ ] 方法注释是否完整
- [ ] 关键代码是否有注释
- [ ] 注释格式是否符合规范
### 代码结构
- [ ] 类结构是否合理
- [ ] 方法顺序是否符合规范
- [ ] 包结构是否合理
- [ ] 导入语句是否规范
### 设计原则
- [ ] 是否遵循单一职责原则
- [ ] 是否遵循开闭原则
- [ ] 是否合理使用设计模式
- [ ] 代码是否易于扩展
## 注意事项
1. **代码规范文件必须**:必须先创建 `/projectdocs/sample/code_standard.md` 文件
2. **以规范为准**:严格按照规范文件中的标准进行评审
3. **具体明确**:问题描述要具体,标注文件名和行号
4. **提供示例**:每个问题都提供改进示例
5. **客观公正**:评审应该基于规范标准,而非个人喜好
6. **模板参考**:可以参考 `/projectdocs/sample/code_standard_template.md` 编写自己的规范