SuperAPI AI 工具集

python

编程与开发

查看项目

更新于 10-16 02:35

技能介绍

该技能是一份覆盖整个 Python 编程流程的综合指南,要求在 Python 项目中编写任何代码之前必须先查阅,以确保遵循统一规范。

用途:为 Python 项目提供一致的编码与工具链标准,减少类型、异常、日志、异步等方面的随意写法。

主要能力与规范: 工具链:类型检查 ty check <FILE_PATH> --output-format concise;Lint 用 ruff check --fix --unsafe-fixes <FILE_PATH>;格式化用 ruff format <FILE_PATH>;测试用 uv run pytest;依赖同步用 uv sync --upgrade;禁止直接使用 python,改用 uv run。

参考文档:深入修改相关代码前必须先读对应文档,涉及 async-programming.md(改 anyio/异步代码前)、type-hints-cheat-sheet.md(改复杂类型注解前)、exceptions.md(改错误处理前)、logging.md(改日志前)。

代码标准要点:包内引用优先相对导入且不超过两级,三级以上用绝对导入;复杂返回值用 TypedDict;类型别名用 Python 3.12+ 的 type 语句;类优先用 @attrs.define 或 @attrs.frozen(除非需要 Pydantic、异常或 TypedDict);异步统一用 anyio,并行任务用 create_task_group,异常用 except* 处理;用 match 替代链式 isinstance;资源类 API 须实现上下文管理器;函数用卫语句降低缩进层级;入口用 @logger.catch;except Exception 仅在必要时使用并加 # noqa 与说明。

适用场景:遵循该规范的 Python 项目开发、重构与代码审查。限制:资料未提供安装方式、收费、价格或平台信息,具体命令与规则须以原始技能文档为准。