SuperAPI AI 工具集

code-style

编程与开发

查看项目

更新于 10-16 00:23

技能介绍

用途:在编写或审查 Python 代码时提供统一的风格与格式标准,主要围绕 Ruff 工具落地。

主要能力: 格式化:使用 Ruff(ruff format .);缩进 4 个空格;最大行宽 120 字符;多行集合使用尾随逗号。 命名约定:函数与变量用 snake_case;类用 PascalCase;常量用 UPPER_SNAKE_CASE;私有成员用 _leading_underscore;模块文件用 snake_case.py。 类型注解:所有函数参数与返回类型必需;可空类型用 Optional[T] 或 T | None;Python 3.10+ 使用小写 list[T]、dict[K, V]。 文档字符串:使用 Google 风格,所有公共函数、类与模块必需,包含 Args、Returns、Raises 段。 导入:用 Ruff 排序(替代 isort),按标准库、第三方、本地分组,使用绝对导入,避免通配符导入。

使用方式(命令保持原样): 格式化:ruff format . 检查:ruff check . 自动修复:ruff check --fix .

适用场景:团队或个人在编写、评审 Python 代码时统一风格,配合 Ruff 完成格式化与静态检查。

限制:资料仅给出上述规范内容,未提供安装步骤、版本要求、配置细节、收费与价格信息,均暂未提供。