用途:在构建 Python 3.11+ 应用时使用,尤其是需要类型安全、异步编程或健壮错误处理的场景。
主要能力:编写完整类型覆盖的 Python 代码;实现 async/await 的 I/O 模式;搭建带 fixture 与 mock 的 pytest 测试套件;使用推导式、生成器、上下文管理器写出 Pythonic 代码;用 Poetry 构建包与项目结构;进行性能优化与剖析。
工作流:分析代码库(结构、依赖、类型覆盖、测试套件);设计接口(Protocol、dataclass、类型别名);实现带完整类型提示与错误处理的代码;编写覆盖率超过 90% 的 pytest 套件;运行 mypy --strict、black、ruff 验证。若 mypy 失败需修复类型错误后重跑;测试失败需调试断言、更新 fixture 直至通过;ruff/black 报错则自动修复后重新验证。
约束:所有函数签名与类属性必须有类型提示;遵循 PEP 8 并用 black 格式化;使用 Google 风格 docstring;测试覆盖率超过 90%;用 X | None 而非 Optional[X];I/O 操作使用 async/await;优先 dataclass 而非手写 init;用上下文管理器处理资源。禁止省略公共 API 类型注解、使用可变默认参数、不当混用同步与异步、忽略 strict 模式 mypy 错误、裸 except、硬编码密钥或配置、使用已弃用标准库模块(用 pathlib 而非 os.path)。
参考文档按上下文加载:类型系统、异步模式、标准库、测试、打包。输出模板包括带完整类型提示的模块文件、pytest fixture 测试文件、mypy --strict 通过确认及所用 Pythonic 模式的简要说明。
限制:资料未提供安装命令、收费与价格信息,也未说明具体平台支持范围。