用途:为 Python 代码提供统一的风格与质量检查规范,覆盖格式化、lint 和静态类型检查,适合在编写、修改或检查 Python 代码时使用。
主要能力:用 ruff 替代 black、isort、flake8 完成格式化与 lint;用 basedpyright 替代 mypy 做严格类型检查。规范涵盖类型注解(推荐 X | None、内置泛型 list/dict)、f-string 格式化、isort 导入顺序、Google 风格 docstring、命名规范(模块 snake_case、类 PascalCase、常量 UPPER_SNAKE_CASE、私有加 _)、异常处理(捕获具体异常、不用裸 except)。
使用方式:格式化执行 ruff format .;lint 自动修复执行 ruff check . --fix,仅检查执行 ruff check . --no-fix;类型检查执行 basedpyright,单文件为 basedpyright src/module.py。配置写入 pyproject.toml,ruff 可设 target-version、line-length、fix 与 lint.select/ignore;basedpyright 可设 pythonVersion、typeCheckingMode(strict)等,存量项目建议先从 standard 迁移。CI 中可运行 ruff format --check .、ruff check . --no-fix 与 basedpyright。
限制:资料未提供该技能的安装方式、版本要求与具体平台支持,需以官方说明为准。