用途：为使用 Speakeasy 生成 SDK、Terraform Provider 或 MCP 服务器提供最佳实践参考，覆盖 OpenAPI 规范准备、代码优先提取、生成工作流、各语言指南、定制与测试的完整生命周期。
主要能力：生成 SDK、Terraform Provider、MCP 服务器；从 FastAPI、Flask、Django、Spring Boot、NestJS、Hono、Rails、Laravel 等代码提取 OpenAPI 规范；修复 OpenAPI 校验错误与应用 overlay；定制钩子、认证、错误处理、重试、分页；测试生成的 SDK（集成、契约、Arazzo）；了解 TypeScript、Python、Go、Java、C#、Ruby、PHP 的语言模式；在 workflow.yaml 中升级 Speakeasy CLI 版本；规范或版本变更后重新生成 SDK；定制 SDK README；通过 overlay 向 OpenAPI 规范添加示例。
使用方式：该技能在相对于本文件的 content/ 子目录中包含详细指南，应按用户任务阅读具体指南，而非仅凭索引作答。指南也可通过 Speakeasy CLI 访问：speakeasy agent context [path]。索引提供快速路由表与决策树，并列出目录结构（plans、code-first、spec-first、sdk-languages、sdk-customization、sdk-testing、terraform 及 CLI_REFERENCE.md）。常见工作流包括首次生成 SDK、现有代码库转 SDK、SDK 定制、多目标 SDK、SDK 扩展、升级并重新生成。
常用命令：speakeasy quickstart --skip-interactive --output console -s spec.yaml -t python -o ./sdk；speakeasy run -y --output console；speakeasy lint openapi --non-interactive -s spec.yaml；speakeasy auth login。
限制：资料未说明收费、价格、平台要求或效果保证。处理大型 OpenAPI 文档时不应将完整规范载入上下文，建议使用 yq 或 jq 提取所需片段；若不可用则以定向 grep 代替。缺少规范或代码时无法继续。具体支持范围与行为以实际文档和 CLI 为准。