源码 ↗

wshobsonpython-code-style

用途概括Python 代码风格技能提供基于 ruff/mypy/pyright 的 lint、格式化、命名与文档规范。给出 pyproject 配置、PEP 8 命名规则和 Google 风格文档模板。价值：形成一致、可维护、自动强制的代码库，具备清晰文档与类型安全。

业务领域

Coding

技能形态

Style Guide
所需工具
ruff
语言环境
python
包管理器
pip
技能组成
  • SKILL.md100.0%

技能解析

何时触发 · 如何工作 · 产出什么

剖析技能的工作原理和产出物，快速判断你的场景与价值。

触发时机

编写新 Python 代码、审查代码风格、配置 linter（ruff/mypy/pyright）、编写文档字符串或建立项目编码规范时使用。

工作机理

  • 推荐 ruff 作为一体化 lint/格式化工具，提供 pyproject.toml 配置示例
  • 遵循 PEP 8 命名规范（snake_case、PascalCase、SCREAMING_SNAKE_CASE）
  • 提供 Google 风格文档字符串模板（函数/类）
  • 展示导入组织与行宽（120）格式化规则

产生结果

形成一致且自动强制的 Python 代码库，具备清晰文档、类型标注的公共 API 与统一风格，降低审查成本。