SuperAPI AI 工具集

python

编程与开发

查看项目

更新于 10-16 05:01

技能介绍

用途:该技能用于 Python 3.10+ 的开发辅助,在用户要求编写、调试、审查或重构 Python 代码时触发;也适用于仓库中存在 *.py、pyproject.toml、requirements.txt、Pipfile 或 poetry.lock 的项目,以及需要异步编程(asyncio)、类型提示或现代 Python 特性建议的场景。

主要能力:按“感知—推理—行动”流程工作。感知阶段检查项目根目录以识别包管理工具(pyproject.toml 对应 Poetry/PDM/Ruff,requirements.txt 对应 pip,environment.yml 对应 Conda),探测 Python 版本要求(最低 3.10+),并识别应用类型(Web API 如 FastAPI、Flask、Django,数据科学如 Pandas、PyTorch,或 CLI 工具)。推理阶段评估代码是否遵循 3.10+ 惯用法(如 match/case、| 联合类型),判断是否引入类型检查(MyPy/Pyright)或自动格式化(Ruff/Black),并按项目规模推荐架构模式。行动阶段编写带完整类型提示的代码,优先使用 X | Y 语法,偏好 match 语句(3.10+)、TaskGroup(3.11+)和新泛型语法(3.12+),并确保代码通过静态分析与单元测试。

编码标准:所有函数签名强烈建议类型提示,使用 3.10+ 联合语法如 list[int | str];遵循 PEP 8,推荐用 ruff 作为 linter 和 formatter;异步处理使用 3.11+ 的 asyncio.TaskGroup 管理并发任务;错误处理使用具体异常类型,并利用 3.11+ 的 ExceptionGroup 与 except* 语法。

工具建议:linter/formatter 用 ruff;类型检查用 mypy 或 pyright;测试用 pytest 配合 pytest-asyncio 或 pytest-cov;包管理用 Poetry 或 uv 以保证依赖锁定与环境一致。

交付物:代码质量报告(指出不符合 3.10+ 现代语法或 PEP 8 的部分)、最佳实践建议(如将复杂逻辑重构为 match/case)、以及附带测试用例并通过类型检查的 Python 源码。

验证要求:代码须能在 Python 3.10+ 环境运行;函数应有 Docstring(Google 或 NumPy 风格);复杂逻辑应包含单元测试;所有公开 API 应有完整类型提示。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;该技能依赖 Python 3.10+ 环境,部分特性需更高版本(TaskGroup 需 3.11+,新泛型语法需 3.12+)。