SuperAPI AI 工具集

python-code-review

编程与开发

查看项目

更新于 10-16 09:44

技能介绍

用途:按本仓库制定的质量标准审查 Python 代码,适用于提交前自查与审查他人代码。

主要能力:围绕四个维度检查。代码风格对照 python-code-quality,关注参数与返回值类型注解、用 X | None 替代 Optional[X]、使用内置泛型、命名规范(PascalCase/snake_case/UPPER_SNAKE_CASE、私有前缀、不遮蔽内置名)、Google 风格 docstring。测试质量对照 python-pytest,关注核心逻辑覆盖率不低于 80%、正常/异常/边界路径、单一行为断言、AAA 模式、fixture 与 mock 使用。简洁性对照 python-simplifier,关注函数不超过 30 行、嵌套不超过 3 层、参数不超过 5 个、重复逻辑、魔法值、长 if-elif 改字典或 match-case、提前返回。最佳实践对照 python-best-practices,关注 set/Counter/deque 选择、生成器、缓存、join 拼接,以及可变默认参数、闭包循环变量、与 None 比较等陷阱。

使用方式:审查后按固定结构输出结论,包含符合项、待改进项(含位置与建议)、必须修复的阻断问题、分维度评分。提交或合并前可运行下列命令:ruff format .;ruff check . --fix;basedpyright;pytest tests/test_affected_module.py -v;pytest tests/test_affected_module.py --cov=src/affected_module --cov-report=term-missing。

限制:标准来自本仓库,未提供通用或官方规范说明;未提供安装方式、平台支持、收费与价格信息,均暂未提供。