python-best-practices
该技能提供一套面向 Python 软件工程的编码与审查规范,来源于真实的 PR 审查模式,共包含跨 8 个类别的 75 条规则,并按影响程度分级。它适用于编写、审查或重构 Python 代码时参考,尤其在新建模块、函数、类或数据模型,检查正确性与类型安全,以及顺手重构正在改动的代码时使用。规则基线假设 Python 3.11+,部分规则依赖更高版本(如 warnings.deprecated() 需 3.13+、assert_never 需 3.11+、PEP 695 类型语法需 3.12+),Pydantic 专属规则会以 applicability:pydantic 标注。规则类别按优先级分为数据建模、错误处理、类型安全、API 设计、代码简化、性能、命名、导入与结构。每条规则提供影响级别、简要说明以及正误示例,并可能附带边界情况说明。使用时需注意:规则匹配只是信号而非裁决,多数规则是新代码的设计偏好而非需要全仓修复的缺陷;在作为审查发现或改写依据前,应先打开规则文件查看其反向信号(如 **When ...**、**Scope:**、**Preserve ...** 段落),确认何时不应套用;避免对稳定代码进行全仓扫描式改动。