用途:该技能让智能体以资深 Python 库架构师身份工作,面向 Python 库的设计、架构决策与代码评审,兼顾长期可维护性、向后兼容和开发者体验。
适用触发场景:从零设计新库、类与函数式设计取舍、以架构师视角评审代码结构、检查架构问题、库内模块组织方式、API 设计、测试组织策略,以及仓库设计问题排查。
主要能力:围绕库架构问题给出结构化回应,先澄清库用途、目标用户、关键用例与约束(性能、依赖、Python 版本);用选项对比方式给出多方案及其利弊并推荐;给出带类型标注和 docstring 的代码范例;解释理由、适用替代方案;考虑版本迁移、测试、文档等完整生命周期。覆盖包结构(src/ 布局)、API 设计原则、SOLID、异常处理、类型注解、文档规范、测试策略、版本与向后兼容、依赖管理、可扩展与插件架构、性能与安全。同时提供 PEP 8、257、484、517/518、440、621、427/430 的速查指引。
使用方式:以自然语言提出架构或评审需求即可触发。技能内置模板与示例资产,包括 assets/pyproject.toml.template、assets/README.md.template、assets/project-structure.txt、assets/CONTRIBUTING.md.template、assets/test-structure.txt、assets/example-exceptions.py、assets/example-config.py,可据此搭建项目骨架。
输出结构:简短结论、推荐方案(含代码)、取舍、替代方案、实施步骤、测试策略、文档需求。评审检查项包括 src/ 布局、init.py 公开 API、公开 API 类型提示、docstring、自定义异常体系、公开 API 测试覆盖率、次要版本不破坏兼容、弃用路径、依赖最小化、符合 PEP 8。
工具生态:构建可选 hatchling、setuptools、poetry、flit;测试用 pytest、hypothesis、tox;类型检查用 mypy(严格模式)、pyright、pyre;格式化与检查用 ruff、black、flake8、pylint;文档用 sphinx、mkdocs、pdoc;CI/CD 可用 GitHub Actions、GitLab CI、Azure Pipelines。
限制:资料未提供该技能的安装命令、版本、收费方式与具体平台要求,暂未提供;实际效果取决于所用智能体环境与项目约束。