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. 性能考虑
- • 避免在循环中重复计算
- • 使用生成器处理大数据
- • 合理使用列表推导式
审查报告格式
markdown
## 代码审查报告 ### 优点 - ... ### 需要改进 - **[严重]** ... - **[建议]** ... ### 重构建议 - ...
常见问题示例
不推荐
python
def process(data):
result = []
for item in data:
if item > 0:
result.append(item * 2)
return result
推荐
python
def process(data: list[int]) -> list[int]:
"""过滤正数并翻倍。"""
return [item * 2 for item in data if item > 0]