SuperAPI AI 工具集

python-pro

编程与开发

查看项目

更新于 10-16 00:22

技能介绍

用途:面向 Python 3.11+ 的现代工程实践,帮助编写类型安全、异步优先、可投入生产的代码。适用场景包括为代码补全类型覆盖、实现 async/await 的 I/O 模式、搭建 pytest 测试套件、使用推导式与生成器等 Pythonic 写法、用 Poetry 组织项目结构,以及性能优化与剖析。\n\n核心流程:先分析代码库的结构、依赖、类型覆盖与测试;再设计接口,定义 Protocol、dataclass 与类型别名;随后实现带完整类型提示与错误处理的代码;接着用 pytest 编写测试,目标覆盖率超过 90%;最后运行 mypy --strict、black、ruff 进行校验。若 mypy 报错需修复类型问题后重跑;测试失败需调试断言、调整 fixture 直至通过;ruff/black 有问题则自动修复后重新校验。\n\n约束方面:所有函数签名与类属性需带类型提示,遵循 PEP 8 并使用 black 格式化,编写 Google 风格 docstring,测试覆盖率超过 90%;用 X | None 替代 Optional[X];I/O 密集操作使用 async/await;优先使用 dataclass 与上下文管理器;不得省略公共 API 的类型注解、使用可变默认参数、混用同步与异步、忽略 strict 模式下的 mypy 错误、使用裸 except、硬编码密钥配置,或使用已弃用的标准库模块。\n\n使用方式:按上下文加载 references 目录中的类型系统、异步模式、标准库、测试、打包等参考文档。作为 AIX skill pack 的一部分,其用户侧别名为 aix-python-pro,调用该别名即使用本技能;生成的产物写入 .aix/ 目录,写入前用 mkdir -p .aix 确保目录存在,.aix/ 中的文件可能被覆盖,除非明确要求否则不写入项目根目录。\n\n限制:资料未提供具体收费、价格、平台兼容范围或性能数据,这些信息暂未提供。