用途:该技能是 GRAVITAS 基础技能在 Python 项目上的扩展。使用时须先加载 skills/gravitas/SKILL.md,再加载本文件。
主要能力:Python 代码勘察(pyproject.toml 中的 mypy、ruff、pytest 配置,setup.py/setup.cfg、requirements、conftest.py、init.py、py.typed 与类型存根);类型检查、静态检查、格式检查与 pytest 验证;类型安全与反模式指导(避免裸 except、避免覆盖内置名、要求类型注解、用 dataclass 或 Pydantic 替代裸字典);列出常见失败模式及修复(Optional 判空、返回类型不符、缺少 return、导入错误、缺存根、循环导入);pytest fixture、测试结构、parametrize 用例及 FastAPI/Django 注意事项。
使用方式:按顺序执行 mypy . --strict、ruff check .、ruff format --check .、pytest -v --tb=short;可用 pytest --cov=src --cov-report=term-missing -v 做覆盖率,pytest --pdb 失败调试,pytest --durations=10 查看慢测试。
适用场景:Python 项目的类型规范、静态检查与测试质量把关。
限制:资料未说明支持的 Python 版本范围、许可与安装方式,也未验证与 pyright、flake8 的具体调用示例。