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]