SuperAPI AI 工具集

python

编程与开发

查看项目

更新于 10-16 04:30

技能介绍

用途:帮助编写、重构和审查符合专业风格指南的 Python 代码,提升可读性与可维护性。

主要能力:强制命名约定(模块 module_name.py、包 package_name、类 PascalCase、函数与变量 snake_case、常量 UPPER_CASE、私有属性前导下划线、强私有属性双下划线);规范导入(使用完整包路径,按标准库、第三方、本地应用顺序排列);文档字符串(模块、类、函数、方法均用三引号,含 Args、Returns、Raises 等段落);类型注解(函数签名与变量,推荐使用 typing 模块的 List、Dict、Optional 等大写形式);行长度不超过 80 字符,用括号隐式续行,4 空格缩进,顶层定义间空两行;异常处理显式抛出与说明;避免可变默认参数;布尔判断用隐式假值;推导式保持简单;未使用的循环变量加下划线前缀;运行 pylint 并可用内联注释抑制警告。

使用方式:在编写新代码、重构旧代码、审查风格合规性、补充文档或类型提示、整理导入时调用该技能。它会分析违规、引用规则给出改进建议、重写代码段、补充文档字符串、格式化导入与缩进、补全类型注解。

适用场景:Python 项目开发、代码评审、团队规范统一。

限制:资料未提供安装命令、收费方式、平台支持或具体工具集成信息;风格规则以 Google Python 风格指南及 PEP 8/257/484 为参考。