用途:该技能提供 Python 语言约定、现代惯用法与工具链规范,适用于编写、评审、重构或任何涉及 Python 代码的任务。
主要能力:约定以 Python 3.14+ 为基线,不使用向后兼容语法,除非项目明确要求。内容涵盖命名规范(变量/函数用 snake_case、类用 PascalCase、常量用 UPPER_SNAKE_CASE、私有成员用下划线前缀);类型注解(内置泛型 list[str]、dict[str, int],联合类型用 |,type 语句定义别名,避免 Any,泛型使用 3.12+ 的 type parameter 语法,Protocol 做结构化类型,TypeIs/TypeGuard 做类型收窄);数据类与结构化数据(dataclass 的 frozen、slots、kw_only,NamedTuple,Enum/StrEnum);模式匹配与函数(早返回、关键字参数、装饰器保留签名);上下文管理器与生成器;异常处理(捕获具体异常、raise ... from、ExceptionGroup 与 except*);字符串、pathlib、导入分组、类与继承、slots 与 dunder 方法;以及 pyproject.toml 打包与 uv 工具链。
使用方式:技能入口在 ${CLAUDE_SKILL_DIR},并引用四个参考文件:references/typing.md(类型注解、泛型、重载、TypeVar、变体)、references/packaging.md(项目布局、pyproject.toml、uv、依赖管理)、references/modules.md(模块系统、导入、命名空间包)、references/concurrency.md(asyncio、TaskGroup、取消、超时、线程互操作)。
适用场景:需要统一团队 Python 风格、做代码评审、重构旧代码或新建项目时参考。
限制:以 3.14+ 为基线,旧版本项目需谨慎;部分示例依赖 3.11/3.12/3.13 特性;官方未提供安装步骤、价格或平台信息。