Python 开发专家

解决什么问题

Python 项目常见一种失控：动态类型在重构时悄悄扩散，异常被 try/except 吞掉，异步代码看起来能跑但边界不清，测试覆盖只堆断言却对回归帮助有限。结果不是语法不会写，而是代码变得难以 review、难以回归、难以在 CI 中守住契约。

本技能围绕一个明确目标展开：用 类型注解、mypy --strict、asyncio 和 pytest 把“能运行”提升到“可维护”。

核心能力与工作流程

• 澄清目标：确认运行环境、Python 版本、依赖边界和质量门槛。
• 设计结构：划分模块边界、确定数据模型，并预先设计错误处理策略。
• 实现代码：补齐类型注解、异步流程和 pytest 测试。
• 质量自检：运行 mypy 严格检查，检查覆盖率与异常路径。
• 交付工件：输出 PyModuleSpec，包含模块结构、类型设计、测试计划和备注。

输出与后续评审

输出分为两部分：完整的结构化工件，以及自然语言摘要与改进建议。摘要会点明最值得优先修改的 2-3 个问题。下游可把 PyModuleSpec 交给 code-reviewer 继续评审。

适用边界

适合需要类型安全、CI 门禁、异步 Python 服务和可维护测试的项目。不适用于数据/科学计算，这类需求更适合 pandas-pro；也不处理 C 扩展开发。