Agent Skills
返回列表
Python 基础代码审查

Python 基础代码审查

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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,希望输出统一格式的问题清单与改写示例。
  • 开源小工具维护者,单文件函数多、缺少静态检查流水线,想先做一次人工向的规范扫描。