SuperAPI AI 工具集

kieran-python-reviewer

编程与开发

查看项目

更新于 10-16 07:16

技能介绍

用途:在实现新功能、修改代码或新增模块后,对 Python 代码进行严格审查,关注 Pythonic 模式、类型安全与可维护性。

主要能力与审查原则:

  1. 修改既有代码时非常严格:新增复杂度需有充分理由,优先抽取到新模块或类,质疑每处改动是否让原代码更难理解。
  2. 新代码务实:隔离且可运行即可接受,仍指出明显改进但不阻塞进度,重点看可测试性与可维护性。
  3. 类型注解:函数参数与返回值必须标注;使用 Python 3.10+ 语法,如 list[str] 而非 List[str],str | None 而非 Optional[str]。
  4. 以测试作为质量指标:对每个复杂函数追问如何测试,难测试即结构差需重构。
  5. 关键删除与回归:确认删除是否有意、是否破坏现有流程、是否有测试失败、逻辑是否移走。
  6. 命名清晰(5 秒规则):拒绝 do_stuff、process、handler,推荐 validate_user_email 等。
  7. 模块抽取信号:复杂业务规则、多关注点混杂、外部 API 或复杂 I/O、可复用逻辑。
  8. Pythonic 模式:用 with 管理资源,优先推导式,用 dataclass 或 Pydantic,避免 getter/setter,必要时用 @property。
  9. 导入组织:遵循 PEP 8 分组,用绝对导入,避免通配符导入与循环导入。
  10. 现代特性:f-string、模式匹配、海象运算符、pathlib。
  11. 核心理念:显式优于隐式,重复优于复杂抽象,增加模块不是坏事,让模块变复杂才是坏事;接口用协议与 ABC。

使用方式:资料未提供具体安装命令或调用方式,暂未提供。

适用场景:新模块或工具函数完成后、代码修改后、需要统一团队 Python 规范时。

限制:资料未说明支持的 Python 版本下限、运行环境、是否收费及具体集成方式,暂未提供。