用途:对一个 Python 库进行系统性质量审查,覆盖项目结构、打包、代码质量、测试、安全、文档、API 设计与 CI/CD 等维度,输出带评分的审查报告与改进建议。
主要能力:提供 5 分钟快速健康检查命令,包括克隆仓库并进入目录后查看 pyproject.toml 前 50 行、检查 tests/ 并用 uv run pytest --collect-only 确认测试存在、用 uv run pytest --cov=package | tail -20 查看覆盖率、用 uvx bandit -r src/ 做安全扫描。审查维度含 src/ 布局与 py.typed 标记、是否使用 pyproject.toml、类型提示与文档字符串、80% 以上覆盖率与边界用例、密钥与输入校验及 pip-audit、README/API 文档/changelog、命名一致性与默认值、PR 测试与多 Python 版本及安全扫描。列出红旗(无测试、无类型提示、仅 setup.py、固定全部依赖精确版本、无 LICENSE、超过一年无提交)与绿旗(活跃维护、覆盖率超 85%、完善 CI/CD、全程类型提示、文档清晰、语义化版本)。附报告模板,含评级、优势、改进项及严重程度、分类星级评分与优先级建议。
使用方式:按快速检查命令执行,再参照 CHECKLIST.md 与 REPORT_TEMPLATE.md 逐项核对内置最佳实践清单(必需、重要、推荐三档),最后按模板生成报告。
限制:资料未提供具体平台兼容性、价格或安装方式等额外信息;实际评分标准以所依据的《Guide to Developing High-Quality Python Libraries》为准,技能本身不自动执行审查。