用途:在读取或编写 Python 文件(.py、pyproject.toml、requirements.txt)时遵循类型优先、函数式与错误处理模式,仅覆盖语言级惯用法。
主要能力:强调“让非法状态不可表示”。用类型系统在类型检查阶段拦截非法状态:以 frozen dataclass 定义不可变领域模型,避免意外修改;用 Literal 构造判别联合(如 Success/Failure 及 RequestState 联合),配合 match 做分支处理;用 NewType 区分 UserId 与 OrderId 等域原语,防止传错;用 Protocol 做结构化类型,无需继承即可接受任何具备 read() 方法的对象。
错误处理与日志:捕获异常后用 raise ... from err 链接异常,保留原始 traceback。日志使用模块级 logger,并以 %s 做延迟字符串插值,例如 logging.getLogger("myapp.widgets") 与 logger.debug("creating widget: %s", name)。
类型检查器选择(可选):提及 ty(Astral 出品,Rust 编写,比 mypy、pyright 更快,处于早期快速演进阶段),可用 uvx ty check 直接运行,或 uvx ty check src/ 检查指定路径;在 pyproject.toml 中可配置 [tool.ty] python-version。选择建议:ty 最快,适合 CI 与大型代码库;pyright 类型推断最完整并有 VS Code 集成;mypy 成熟且插件生态丰富。
适用场景:编写或审阅 Python 代码、配置 Python 项目文件时参考上述模式。
限制:该技能只涉及语言特定惯用法;未提供安装、收费、性能数据等其它信息。