SuperAPI AI 工具集

python-services

编程与开发

查看项目

更新于 10-15 22:17

技能介绍

用途:为 Python CLI 工具、异步并发与后端服务开发提供统一的工作规则与验证要求,适合在编写或审查 Python 代码、构建 CLI 应用与 FastAPI 服务时使用。

主要能力与规则:在边界处校验外部输入与响应,并保留异常原因;区分“缺失结果”与“空结果”,当空集合代表成功时应要求响应字段存在,而非默认置空,并针对缺失、拼写错误、显式空、有数据四类载荷通过真实校验边界进行测试。简单顺序任务保持同步;并发的任务要有界,保留取消语义并保留任务引用。网络调用需设置超时,只对失败及语义允许的操作进行重试。任务幂等性通过原子写入与数据库约束来保证。保持已发布 API 行为与共享迁移历史不变。遥测需对应具体的运维问题并验证其输出。

纪律要求:优先简洁,改动尽可能小、只改必要部分,避免无关变更;不使用取巧的临时方案;新增抽象前先确认已在 3 处以上出现,否则内联。

验证方式:uv run pytest 需零失败通过;uv run ruff check . 需零警告通过;uv run ty check . 需零错误通过;覆盖率目标 80% 以上(uv run pytest --cov,可加 --cov-report=html 生成可浏览报告)。

任务相关参考:打包、环境配置、CLI 设置或 pytest 行为参见 tooling-and-tests.md;asyncio、后台任务、重试、连接池、超时或健康检查参见 concurrency-and-resilience.md;API、校验、错误、迁移、日志、指标或追踪参见 service-boundaries.md;相关主题适用时还有 cli-tools.md 与 fastapi.md。

限制:资料未提供具体安装命令、版本要求、收费或平台信息;以上命令需在具备 uv 环境的项目中运行。