代码审查助手（自动化）

## 技能概述

代码审查助手（自动化）是一款基于大语言模型的智能审查工具，旨在帮助开发者快速发现代码中的潜在缺陷、代码风格问题以及可优化的实现细节。通过自然语言描述，它能够针对用户提交的代码片段进行静态分析，输出结构化的审查报告，包括问题描述、严重程度、修复建议和示例代码。该技能适用于日常开发、代码合并前的质量把关以及团队内部的代码规范统一。

## 功能特性

- **多语言支持**：覆盖常见编程语言如 Python、Java、JavaScript、TypeScript、C++、Go、Rust 等，用户只需在输入时注明语言标签即可获得针对性分析。
- **问题分级**：依据对系统稳定性和安全性的影响，将检测到的问题划分为 **错误（Error）**、**警告（Warning）**、**提示（Info）** 三类，帮助开发者快速定位关键缺陷。
- **风格检查**：内置主流代码风格指南（如 PEP8、Google JavaScript Style Guide）的规则，自动识别缩进、命名、注释、空行等不合规之处。
- **改进建议**：针对每个问题提供明确的修复思路、最佳实践以及可参考的文档链接，帮助开发者快速学习和改进。
- **可扩展规则**：用户可通过配置文件（JSON/YAML）自定义规则集，实现团队内部的代码规范定制。

## 适用场景

- **提交代码后立即审查**：在本地完成功能开发后，将代码粘贴至对话中并说明语言，系统即时返回审查结果。
- **Pull Request 检查**：将待合并的代码块粘贴至审查助手，获取潜在风险评估后再决定是否进入人工评审。
- **代码教学与反馈**：在教学或代码评审场景中，快速提供改进建议，帮助学习者形成良好的编码习惯。

## 调用步骤

1. **准备代码**：将需要审查的代码片段复制到剪贴板，确保代码完整且不含敏感信息。
2. **指定语言**：在对话开头以自然语言说明代码所使用的语言，例如“以下 Python 代码请审查”。
3. **发送请求**：直接粘贴代码并加上“审查”或“Review”关键词，例如：“请帮我审查下面的代码”。
4. **获取报告**：系统在几秒内返回结构化的 Markdown 报告，包含问题列表、严重程度、具体位置和修复示例。
5. **采纳建议**：根据报告逐项修改代码，若有疑问可在同一对话中继续追问，助手会进一步解释或提供更深层次的优化方案。

## 示例

**输入**  
```
以下 JavaScript 代码请审查：
```js
function add(a,b){
    return a+b;
}
```
**输出**  
```markdown
## 审查报告（JavaScript）

### 错误（Error）
1. **函数命名不符合驼峰规范**  
   - **位置**：第 1 行 `function add(a,b){`  
   - **建议**：改为 `function add(a, b) {` 并使用 CamelCase 命名。  
   - **示例**：`function add(a, b) { return a + b; }`

### 警告（Warning）
1. **参数之间缺少空格**  
   - **位置**：第 1 行 `a,b`  
   - **建议**：在参数之间添加空格以提升可读性。  
   - **示例**：`function add(a, b) { ... }`

### 提示（Info）
1. **建议添加函数文档注释**  
   - **建议**：使用 JSDoc 注释说明函数的参数和返回值类型。  
   - **示例**：  
   ```js
   /**
    * 计算两个数的和
    * @param {number} a - 加数
    * @param {number} b - 被加数
    * @returns {number} 两数之和
    */
   function add(a, b) { ... }
   ```
```

## 注意事项

- **仅限静态分析**：代码审查助手基于文本分析，无法执行代码或捕获运行时错误。重要的业务逻辑仍需人工测试验证。
- **敏感信息保护**：请勿在代码中包含密码、密钥、个人隐私数据等敏感信息，系统不会对上传内容进行持久化存储。
- **误判可能性**：由于模型的推理限制，极少数情况下可能出现误判或漏报，建议结合团队规范和实际业务需求进行二次确认。
- **自定义规则**：团队若需引入特定业务规则，请参考配置文件格式自行扩展，系统会在审查时自动加载对应的规则集。
- **多语言混合**：若代码片段中混有多种语言（如模板引擎嵌入的 HTML），请在请求中说明主要语言，以便模型选择合适的分析策略。

通过上述流程，开发者可以在不离开对话界面的情况下完成高效、规范的代码审查，有效提升代码质量和团队协作效率。