python-code-reviewer

name	python-code-reviewer
description	审查 Python 代码，提供改进建议，确保代码质量和最佳实践

Python Code Reviewer Skill

当用户请求代码审查或询问 Python 代码质量时，使用此技能进行全面评估。

审查清单

1. 代码风格 (PEP 8)

• 缩进使用 4 个空格
• 行长度不超过 79 字符（或 99 字符）
• 导入语句分组排序
• 命名规范（snake_case 函数/变量，PascalCase 类）

2. 类型提示

• 函数参数有类型注解
• 返回值有类型注解
• 复杂类型使用 typing 模块

3. 文档

• 模块有 docstring
• 公共函数有 docstring
• 复杂逻辑有注释

4. 错误处理

• 使用具体的异常类型
• 不要裸露的 except:
• 适当使用 try/except/finally

5. 性能考虑

• 避免在循环中重复计算
• 使用生成器处理大数据
• 合理使用列表推导式

审查报告格式

## 代码审查报告

### 优点
- ...

### 需要改进
- **[严重]** ...
- **[建议]** ...

### 重构建议
- ...

常见问题示例

不推荐

def process(data):
    result = []
    for item in data:
        if item > 0:
            result.append(item * 2)
    return result

推荐

def process(data: list[int]) -> list[int]:
    """过滤正数并翻倍。"""
    return [item * 2 for item in data if item > 0]