適用於 Openclaw 的 API Generator

一個強大的 CLI 工具,用於生成生產就緒的 API 腳手架,包括 REST、GraphQL、身份驗證和測試套件。

ckchzh
v2.0.0
Mar 18, 2026
3
3.3k
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install api-generator

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 api-generator。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 API Generator?

API Generator 是一個以開發者為中心的工具,旨在消除後端腳手架的重複任務。作為 Openclaw Skills 生態系統的關鍵組件,它提供了一個流線型介面,用於為 RESTful 終端、GraphQL 模式和 OpenAPI 文件生成高質量代碼。無論您是從頭開始構建微服務,還是向現有專案添加新資源,此工具都能確保您的 API 架構一致、文件齊全且安全。

透過利用這項技能,開發人員可以專注於業務邏輯而不是樣板代碼。生成的代碼針對現代環境進行了優化,支援 Web 服務的 Express.js 並提供 Python 中的強大用戶端函式庫。它透過提供即時模擬伺服器和全面的測試套件,彌合了設計與實現之間的差距,使其成為快速原型設計和生產開發的必備工具。

API Generator 應用場景

  • 使用 Express.js 快速引導 RESTful CRUD 服務。
  • 設計複雜的 GraphQL 模式,包括類型、查詢和變更。
  • 自動生成 OpenAPI 3.0/Swagger 文件,以實現更好的團隊協作。
  • 以極小的代價實現安全的身份驗證流,如 JWT、OAuth 或 API Keys。
  • 創建模擬 API 伺服器和 Jest 測試套件,以便在開發過程中驗證終點。

API Generator 運作原理

  1. 確定需要透過 API 公開的資源或數據模型。
  2. 使用所需的協定命令(例如 rest 或 graphql)從 Openclaw Skills 庫執行 apigen.sh 腳本。
  3. 透過命令列選項指定額外要求,如身份驗證類型或速率限制策略。
  4. 該工具處理請求並生成帶完整註釋的生產級代碼。
  5. 從 stdout 擷取輸出並將其直接透過管道傳輸到您的專案檔案中,或在終端機中進行查看。

API Generator 設定指南

要在您的 Openclaw Skills 環境中開始使用此工具,請確保腳本在專案目錄中可用且可執行。

# Navigate to your skills directory
cd ai-skills

# Ensure the generator script is executable
chmod +x scripts/apigen.sh

# Run a test generation to verify setup
bash scripts/apigen.sh rest health-check

API Generator 資料結構與分類體系

API Generator 生成旨在直接整合到應用程式原始碼樹中的結構化代碼。輸出數據的組織方式如下:

數據類型 格式/語言 描述
REST Code JavaScript (Express) 包含路由和控制器的完整 CRUD 邏輯
GraphQL Schema Definition 類型定義和變更/查詢結構
Docs OpenAPI 3.0 (YAML/JSON) 標準化的 API 規範
Clients Python 用於程式化存取的可重用類別用戶端
Tests Jest/Supertest 自動化單元和整合測試

API Generator 進階特性

  • 多協定支援,允許在 REST 和 GraphQL 架構之間無縫切換。
  • 整合安全模組,用於快速部署 JWT 和 OAuth 2.0 身份驗證。
  • 複雜的速率限制選項,包括權杖桶和滑動窗口實現。
  • 自動生成模擬伺服器以解鎖前端開發團隊。
  • 可定制的輸出重新導向,方便整合到現有的 Openclaw Skills 自動化流水線中。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*