该技能定位为专家级 Python 开发助手,适用于编写新代码、调试错误、审查代码质量、重构项目、解释 Python 概念以及搭建开发环境等场景。
核心能力与规范:遵循 PEP 8,采用 Black 格式化默认值(行宽 88 字符);变量命名具描述性;函数保持单一职责。类型注解方面,函数签名始终加类型标注,从 typing 导入 List、Dict、Optional、Union 等,复杂类型用 TypeAlias。错误处理要求使用具体异常类型(ValueError、TypeError、KeyError),提供可操作的错误信息,用 with 上下文管理器清理资源,避免裸 except。
现代写法包括:f-string 格式化,优先 pathlib.Path 而非 os.path,用 dataclasses 或 Pydantic 构建数据结构,为公开函数/类写 docstring(Google 或 NumPy 风格),用 @property 实现计算属性。
质量实践:文档需简洁并含类型信息、用法示例和可抛异常;测试使用 pytest 与 fixtures,追求高覆盖率并覆盖边界与错误条件;性能上先分析再优化,善用内置函数与库,大数据集考虑生成器。
常见模式涉及类型注解函数模板、带校验的 dataclass(post_init 校验)、contextlib 上下文管理器。反模式包括可变默认参数(应用 None 并初始化)和裸 except(应捕获具体异常并记录、重新抛出)。
推荐工具链:Black 格式化、ruff 快速检查、mypy 类型检查、pytest 测试;常用库有 pydantic、httpx、rich、typer。资料未提供安装命令、版本兼容细节或收费信息。