speakeasy-api/speakeasy
GitHub: speakeasy-api/speakeasy
一款基于 OpenAPI 规范自动生成类型安全的多语言 SDK、Terraform Provider、CLI 及契约测试的现代 API 工具链。
Stars: 427 | Forks: 39
[](https://launchweek.dev/lw/2024/mega#participants)
## 现代的 OpenAPI 原生工具链
Polished and type-safe SDKs, Terraform providers and Contract Tests for your API. 10 Languages and counting.
工作原理
### 功能 - 看起来就像你亲手编写的 SDK 代码。针对性能、可调试性和现代编程范式进行了优化。 - 基于类型安全的 Go SDK 构建的完整 Terraform Providers。 - 使用预构建的 mock-server 生成契约测试（[由 Arazzo 提供支持](https://www.speakeasy.com/openapi/arazzo)） - 生成整洁的代码示例，用于与 API 文档同步。 - 执行 `npm install your-api`。管理版本控制并发布到包管理器。 - 现代的 OpenAPI 3.X 工具链，用于 lint、清理、对比和编辑 specs。（[由 Overlays 提供支持](https://www.speakeasy.com/openapi/overlays)） 查看 [路线图](https://www.speakeasyapi.dev/roadmap) 了解即将推出的内容！
## CLI ### 安装 通过以下方式安装 Speakeasy CLI： - Homebrew - Winget - Chocolatey - Shell 脚本 / GitHub Actions - Docker 请参阅 [Speakeasy CLI 安装文档](https://www.speakeasy.com/docs/create-client-sdks#install-the-speakeasy-cli) 获取更多信息。CLI 版本也可以直接在 [仓库 releases](https://github.com/speakeasy-api/speakeasy/releases) 中获取。 ### 使用方法 请参阅 [Speakeasy CLI 参考](https://www.speakeasy.com/docs/speakeasy-reference/cli) 获取使用文档。此外，每个 CLI 命令和子命令都支持 `--help` 标志以显示使用信息。 ## Agent Skills 通过我们的 [Agent Skills](https://github.com/speakeasy-api/agent-skills) 包，将 Speakeasy 与 AI 编码 agent 结合使用。 ### 安装 ``` npx skills add speakeasy-api/agent-skills ``` ### 支持的平台 - [Claude Code](https://claude.ai/code) - [Cursor](https://cursor.sh/) - [GitHub Copilot](https://github.com/features/copilot) - [Gemini CLI](https://github.com/google-gemini/gemini-cli) - 以及 [其他 15+ 个平台](https://agentskills.io/) ### 使用方法 安装完成后，可以通过 `speakeasy:` 命名空间使用这些 skills： ``` /speakeasy:start-new-sdk-project # Initialize a new SDK project /speakeasy:validate-openapi-spec # Validate an OpenAPI spec /speakeasy:regenerate-sdk # Re-run SDK generation ``` 请参阅 [agent-skills 仓库](https://github.com/speakeasy-api/agent-skills) 获取可用 skills 的完整列表。