⚡

PythonSDK开发专家Skill python-sdk-specialist

Python SDK开发专家技能专注于构建现代化、高性能的Python软件开发工具包。核心能力包括：采用异步编程（async/await）提升并发性能，全面集成类型提示（Type Hints）增强代码可读性与安全性，遵循PEP规范确保代码风格统一。该技能适用于为各类API（如RESTful、GraphQL）设计和实现优雅的客户端库，支持从架构设计、代码实现、测试验证到打包发布（PyPI）的全流程。关键词：Python SDK开发，异步编程，类型提示，API客户端，httpx，aiohttp，PyPI打包，PEP规范，mypy类型检查，pydantic数据验证。

后端开发 0 次安装 0 次浏览 更新于 2/26/2026

name: python-sdk-specialist description: 开发支持异步和类型提示的Python SDK allowed-tools:

  • Read
  • Write
  • Edit
  • Glob
  • Grep
  • Bash

Python SDK专家技能

概述

此技能专精于开发符合Python风格的SDK，全面支持类型提示、异步/等待功能，并遵循现代Python最佳实践，确保兼容Python 3.8+。

能力

  • 遵循PEP指南设计Python风格的SDK架构
  • 使用aiohttp、httpx或asyncio实现异步/等待功能
  • 配置全面的类型提示，支持mypy验证
  • 支持Python 3.8+并妥善处理兼容性问题
  • 实现上下文管理器以管理资源
  • 遵循Python惯例设计直观的API接口
  • 配置适用于PyPI分发的打包方案
  • 实现适当的日志记录和调试支持

目标流程

  • 多语言SDK策略
  • SDK架构设计
  • SDK测试策略

集成点

  • PyPI包注册表
  • pytest用于测试
  • mypy用于类型检查
  • httpx/aiohttp作为HTTP客户端
  • pydantic用于数据验证
  • poetry/setuptools用于打包

输入要求

  • API规范（OpenAPI、GraphQL或自定义）
  • 目标Python版本范围
  • 异步需求
  • 类型严格级别
  • 打包偏好（poetry vs setuptools）

输出成果

  • Python SDK包源代码
  • 类型存根文件（.pyi，如需要）
  • pytest测试套件
  • pyproject.toml配置文件
  • 文档（Sphinx就绪）
  • 示例脚本

使用示例

skill:
  name: python-sdk-specialist
  context:
    apiSpec: ./openapi.yaml
    pythonVersion: ">=3.8"
    asyncSupport: true
    typeHints: strict
    httpClient: httpx
    packageManager: poetry

最佳实践

  1. 遵循PEP 8风格指南
  2. 全程使用类型提示（PEP 484, 585）
  3. 同时实现同步和异步接口
  4. 使用上下文管理器管理连接
  5. 提供全面的文档字符串（Google风格）
  6. 正确支持可选依赖项