SuperAPI AI 工具集

python-conventions

编程与开发

查看项目

更新于 10-16 01:48

技能介绍

用途:当 .py 文件、Python 工具链或 pyproject.toml 是任务主要对象时,按此技能强制统一 Python 项目约定;非 Python 为主或混合语言任务应让位给对应技能。

主要能力:给出硬性要求与引导性偏好两层规则,并提供工具链契约、重定向边界、例外情况、库偏好、性能建议、测试模式等参考文件;按参数分派,空参数显示约定摘要,check 仅做符合性核查,不扩写实现建议。

使用方式:包管理用 uv;依赖用 uv add、uv add --group dev、uv remove、uv lock --upgrade-package <pkg>;可复现安装用 uv sync --locked;配置集中在 pyproject.toml;类型检查用 uv run ty check;检查与格式化用 uv run ruff check、uv run ruff format;测试用 uv run pytest;命令统一加 uv run 前缀。虚拟环境由 uv 自动管理,不手动创建或激活 .venv。完成前运行 python scripts/check.py 与 git diff --check,均需退出码 0。

适用场景:Python 为主的开发与重构、仓库级工具链迁移或合规核查、新 Python 工作的库选择;性能与测试参考仅在相关任务中按需加载。

限制:默认拒绝以 pip install、uv pip install 或裸 python 替代仓库所需工具,拒绝用 mypy 替代 ty;不得手改 uv.lock;例外路径需先对照例外文档。混合语言、CI 设计、性能剖析等不在其职责内。资料未提供具体版本、收费与安装步骤细节。