Python 基础代码审查
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @u_8ee34d77/py-free。
技能介绍
要解决什么问题
团队里常见的 Python 事故并不总是「架构级」:一次 def save(items=[]) 让测试与线上行为分叉;import 乱序和隐式循环依赖让模块在导入期就崩;裸 except: 或只打日志不处理的块把真实错误藏起来;文件句柄没走 with 在异常路径上泄漏;函数没标注返回类型、调用方也没做 None 检查,最后在更深一层才 AttributeError。这些问题靠肉眼扫 diff 既慢又容易漏,尤其在 CR 时间紧、函数又很短的时候。
技能如何工作
py-free(Python 基础版) 把审查拆成五个可单独聚焦的维度,也可一次跑 all:
- 可变默认参数:识别
[]、{}等可变默认值,建议None加函数内初始化 - import 规范:按 PEP 8 分组排序(标准库 / 第三方 / 本地),并提示基础循环依赖风险
- 异常处理:区分
Exception与BaseException,反对裸 except 与吞没异常,倾向用logging记录 - 资源管理:对文件、锁、连接类代码推荐
with改写 - 类型提示:补全基础
type hints,标出可能的None解引用
输入可以是代码片段或文件路径;通过 focus(如 mutable / import / exception / resource / typing)、strict_level(strict / normal / loose)和输出格式控制审查深度与呈现方式,典型产出是问题清单加可落地的改写建议。
适用边界
本技能不覆盖 asyncio / threading / multiprocessing、GIL 与线程安全、Cython / profiling 等性能向议题,也不做 mypy / pyright 级别的完整类型系统分析。需要并发、元类、框架特有陷阱或高级版能力时,应换用对应技能,而不是指望基础版给出深度结论。
使用场景
- 合并 PR 前想快速扫一遍新增工具函数,确认没有可变默认参数和裸 except。
- 重构老模块时把混杂的 import 按标准库、第三方、本地分组,并排查明显的循环依赖。
- 把手动 open/close 的读写逻辑改成 with,避免异常分支里句柄未关闭。
- 给对外 API 函数补 type hints,并标出调用链上可能未检查的 None 返回值。
适合人员
- 负责维护内部脚本库的工程师,需要在 code review 里固定检查五类基础陷阱。
- 从 Jupyter 笔记本迁到可部署模块的数据分析师,不熟悉 import 顺序与资源释放习惯。
- 带初级同事做结对审查的 Tech Lead,希望输出统一格式的问题清单与改写示例。
- 开源小工具维护者,单文件函数多、缺少静态检查流水线,想先做一次人工向的规范扫描。