SuperAPI AI 工具集

python

编程与开发

查看项目

更新于 10-15 17:26

技能介绍

用途:为编写、审查和重构 Python 代码提供规范,强调 PEP 8 风格、语法校验与提交前检查。

主要能力: 风格规范:4 空格缩进(不用 tab);行最长 88 字符(Black 默认)或 79(严格 PEP 8);顶层定义前两个空行、类内一个;导入顺序 stdlib → 第三方 → 本地并按字母排序;函数/变量 snake_case、类 PascalCase、常量 UPPER_CASE。 版本要求:最低 Python 3.10+(3.9 于 2025 年 10 月 EOL),新项目目标 3.11-3.13;不用 Python 2 语法,使用 match、海象运算符、类型提示等现代特性。 语言习惯:优先列表/字典推导、with 上下文管理器、解包、EAFP、f-string、类型提示、dataclass、pathlib、enumerate/zip/itertools。 应避免:可变默认参数、裸 except、全局状态、from module import 、循环内字符串拼接、== None、len(x) == 0。 测试:优先 pytest 或 unittest,文件命名 test_.py,函数 test_*,聚焦单元测试并 mock 外部依赖。

使用方式: 提交前执行语法检查 python -m py_compile *.py;有测试则运行 python -m pytest tests/ -v 2>/dev/null || python -m unittest discover -v 2>/dev/null || echo "No tests found";格式化检查 ruff check . --fix 2>/dev/null || python -m black --check . 2>/dev/null。依赖管理优先 uv,否则 pip;新项目可用 uv init 或 uv venv && source .venv/bin/activate。

适用场景:日常 Python 开发、代码评审、重构与提交前自检。

限制:未提供具体编辑器集成、完整规则集、收费或价格信息。