用途:为 Python 开发提供最佳实践指导,提升代码质量、可维护性与一致性。该技能在处理 *.py 文件、提及 python/最佳实践/风格指南、添加类型提示或文档字符串、重构 Python 代码时自动激活。
主要能力:
- 风格规范:PEP 8,4 空格缩进,代码行最长 79 字符、文档/注释 72 字符,顶层定义间 2 空行、方法间 1 空行;命名使用 snake_case(函数/变量/模块)、PascalCase(类)、UPPER_SNAKE_CASE(常量)、前导下划线表示内部/私有。
- 导入组织:按标准库→第三方→本地分组,统一置于文件顶部;用 TYPE_CHECKING 避免循环导入。
- 类型提示:函数签名始终使用类型提示;Python 3.10+ 用 | 代替 Union,3.9+ 用内置泛型 list[str]/dict[str, int]。
- 文档字符串:采用 NumPy 风格,包含 Parameters、Returns、Raises、Examples、Notes 等分节。
- 异常处理:使用具体异常类型而非裸 except;用上下文管理器管理资源;定义领域自定义异常。
- 常用模式:dataclass 承载数据结构,Enum 表示固定取值集,pathlib.Path 替代 os.path,使用列表推导式。
- 代码组织:模块按文档字符串、导入、常量、异常、函数、类、入口分层;用命名常量替代魔法数字。
- 测试:使用 pytest,配合 assert、pytest.raises、fixture。
使用方式:作为 Claude 技能自动触发,无需手动调用;资料未提供具体安装命令或配置步骤。
适用场景:编写、修改或重构 Python 代码,添加类型注解与文档,统一团队代码风格。
限制:资料未提供收费、价格、平台支持、实际效果或完整安装方式等信息。