SuperAPI AI 工具集

python-modern-standards

编程与开发

查看项目

更新于 10-16 09:51

技能介绍

用途:本技能定义 SaaS 项目中 Python 代码的通用工程标准,适用于新建 Python 项目、服务、脚本或任务 worker,也用于代码审查、重构及 CI 配置。编写或审查任何 Python 代码前应先加载它——项目内其他 Python 技能均假设已读过本规范。

主要能力与不变量:Python 3.11+(默认 3.12,在 pyproject.toml 中固定 requires-python);采用 src/ 布局,不用 setup.py 和扁平布局;用 uv 管理依赖并提交 lockfile;用 ruff 统一格式与 lint(替代 black、isort、flake8);所有函数签名带类型标注,CI 中用 mypy --strict 或 pyright(二选一);外部边界统一用 Pydantic v2;生产用 structlog 输出 JSON;配置经 pydantic-settings,禁止裸用 os.environ;禁止裸 except,需自定义异常层级;测试用 pytest 并在 CI 强制覆盖率阈值。

使用方式:先读 SKILL.md,再按需加载 references/ 下的深入文件;涉及 API、worker、队列、sidecar 或容器化时加载 references/api-container-sidecar-engineering.md,容器化场景与 docker-development 配合。常用命令:uv init、uv add、uv sync、uv run pytest、uv lock --upgrade。CI 门禁包括 ruff format --check、ruff check、mypy --strict src/、pytest 覆盖率检查与 pip-audit。

适用场景与限制:适合 PHP+Android+iOS SaaS 栈中的 Python 服务、脚本与数据任务。同步默认用于脚本与 worker,async 用于 FastAPI 且须保持路径一致,勿混用。安全方面要求密钥走环境变量、SQL 参数化、边界校验、依赖扫描,禁止 eval/exec/pickle 不可信来源。资料未提供具体价格、收费方式及效果数据。