Python 技能包

生成全面的 Python 库文档，包括 Google 风格的文档字符串、Sphinx 设置、API 参考、教程和 ReadTheDocs 配置。适用于编写文档字符串、设置 Sphinx 文档或创建用户指南。

构建和管理开源 Python 库社区，包括 CONTRIBUTING.md、CODE_OF_CONDUCT.md、问题/PR 模板、贡献者认可和 GitHub 自动化。适用于设置社区基础设施、改善贡献者体验或管理项目治理。

管理 Python 库的发布，包括语义版本控制、变更日志维护（遵循 Keep a Changelog 格式）、使用 GitHub Actions 自动化发布流程，以及弃用工作流。适用于发布计划、编写变更日志、自动化发布管道或沟通重大变更。

全面评估 Python 库的质量，包括项目结构、打包、代码质量、测试、安全性、文档、API 设计和 CI/CD，提供可行的反馈和改进建议，适用于库健康评估、重大版本准备或依赖审计。

通过分析（cProfile、PyInstrument）、内存分析（memray、tracemalloc）、基准测试（pytest-benchmark）和优化策略来优化 Python 库性能。适用于分析性能瓶颈、查找内存泄漏或设置性能回归测试。

使用 Bandit、pip-audit、Semgrep 和 detect-secrets 对 Python 库进行安全漏洞审计，识别 SQL 注入、命令注入、硬编码凭证、弱加密和不安全反序列化。适用于库安全审查、CI 中的安全扫描设置或实施安全编码模式。

为 Python 库设计并实现 pytest 测试套件，支持 fixtures、参数化、模拟、Hypothesis 属性测试和 CI 配置。适用于创建测试、提高覆盖率、搭建测试基础设施或实现属性测试。

通过 ruff 检查、mypy 类型检查、Pythonic 习惯和重构来提高 Python 库的代码质量。适用于代码审查、添加类型提示、配置静态分析工具或重构 Python 库代码。

使用现代的 pyproject.toml 和构建后端（setuptools, hatchling）来打包和分发 Python 库，支持 PyPI 发布和轮子构建。适用于库的打包、发布到 PyPI 或解决打包问题。

使用 Click 或 Typer 为 Python 库构建命令行接口，支持命令组、参数处理、进度条、Shell 补全和 CLI 测试。适用于为库添加 CLI 功能或构建独立命令行工具。

根据简单性、一致性和可发现性原则设计直观的 Python 库 API。处理 API 版本演进、弃用、重大变更和错误处理，适用于新库 API 设计、现有 API 改进审核或管理 API 版本和弃用。

该插件用于设置专业的 Python 库项目，支持现代工具链（如 pyproject.toml、uv、ruff、pytest、pre-commit 和 GitHub Actions）。适用于创建新库、现代化现有项目、配置代码检查/测试/持续集成以及设置 Makefile 和预提交钩子。