技能 generate-api-client
📦

generate-api-client

內容修訂 r1 安全 ⚙️ 外部命令

產生型別安全的 API 用戶端

當 OpenAPI 合約變更時，手動更新 API 用戶端容易產生偏移。此 skill 會引導 Orval 產生流程與型別檢查，讓前端用戶端保持一致。

支援: Claude Codex Code(CC)
Maintain this Skill? Claim it 🥉 78 銅級

使用我的智慧代理安裝

將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。

智能體請求
Review the Skillstore skill "generate-api-client" from https://skillstore.io/skills/crearize-generate-api-client.md and its manifest at https://skillstore.io/api/skills/crearize-generate-api-client/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。

Agent 可讀資源

當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。

Markdown 詳情 GET /skills/crearize-generate-api-client.md 已簽名 manifest GET /api/skills/crearize-generate-api-client/manifest 已簽名 lockfile GET /api/skills/crearize-generate-api-client/lockfile

測試它

正在使用「generate-api-client」。 從目前的 OpenAPI 規格產生前端用戶端。

預期結果:

此 skill 會確認規格路徑、執行 Orval、檢查產生的 API 與 model 檔案，並回報型別檢查狀態。

正在使用「generate-api-client」。 在後端端點變更後重新產生 API 用戶端。

預期結果:

此 skill 會根據最新合約更新產生的用戶端，並摘要 TypeScript 驗證是否通過。

正在使用「generate-api-client」。 找出 API 用戶端產生失敗的原因。

預期結果:

此 skill 會分開處理規格查找、產生、檔案驗證與型別檢查，讓失敗階段清楚可見。

安全審計

安全
v10 • 2026/7/9 開啟版本化報告

Most static detections are false positives caused by markdown code fences and read-only ls examples. Two command blocks are confirmed medium-risk because they run pnpm and npx project tooling in a community repository. No prompt injection, data exfiltration intent, or hidden authority claims were found in SKILL.md.

1
已掃描檔案
56
分析行數
2
複核項目
0
已忽略的誤報
能力複核項目 (2)

這些是真實的本機能力，對此技能而言可能是預期行為，因此需要複核，但不會按已確認的惡意行為計分。

中
SKILL.md:21-26
Ruby/shell backtick execution
```bash
This block instructs the agent to run pnpm run generate:api inside the frontend project. Project package scripts can execute arbitrary repository code, so this should require trust and user confirmation.
中
SKILL.md:35-38
Ruby/shell backtick execution
```bash
This block instructs the agent to run npx tsc --noEmit. npx executes package binaries and may resolve tooling from project dependencies or the registry, so it is a real external command risk.

風險因素

⚙️ 外部命令 (9)
SKILL.md:15-18 SKILL.md:18-21 SKILL.md:21-26 SKILL.md:26-29 SKILL.md:29-32 SKILL.md:32-35 SKILL.md:35-38 SKILL.md:38-41 SKILL.md:41-55
審計單位: codex 檢視審計紀錄 →
分享與引用此報告

分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。

開啟版本化報告
安全評估

複製報告連結

https://skillstore.io/skills/crearize-generate-api-client/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/crearize-generate-api-client/security.svg)](https://skillstore.io/skills/crearize-generate-api-client?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/crearize-generate-api-client?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/crearize-generate-api-client/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/crearize-generate-api-client.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
學術引用 (APA · BibTeX · CFF)

APA 引用

Crearize. (2026). generate-api-client security audit report (audit version 10) [Author version unspecified]. Skillstore. https://skillstore.io/skills/crearize-generate-api-client/audits/10

BibTeX 引用

@techreport{crearize-crearize-generate-api-client-2026, author = {Crearize}, title = {generate-api-client security audit report (audit version 10)}, institution = {Skillstore}, year = {2026}, number = {10}, url = {https://skillstore.io/skills/crearize-generate-api-client/audits/10}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "generate-api-client security audit report (audit version 10)" version: "unspecified" type: report authors: - name: "Crearize" date-released: "2026-07-09" url: "https://skillstore.io/skills/crearize-generate-api-client/audits/10" identifiers: - type: other value: "skillstore:crearize-generate-api-client:audit:10" description: "Skillstore immutable audit report identifier"

Skillstore 評分

評分依據 證據置信度: 高
55
架構
85
可維護性
87
內容
70
社群
83
規範符合度

你可以打造什麼

在後端變更後重新整理前端用戶端

在 OpenAPI 合約變更後重新產生 TypeScript API 用戶端，然後確認產生的檔案與型別。

保持全端合約一致

使用單一引導流程，在同一個工作區中驗證後端規格並更新前端用戶端。

標準化產生用戶端的審查

在合併合約或前端整合變更前，套用可重複的 API 用戶端產生檢查清單。

試試這些提示

從目前規格產生 
使用 generate-api-client 確認 OpenAPI 檔案存在、執行已設定的 Orval 產生流程，並回報產生的檔案。
在後端更新後重新產生 
在後端 OpenAPI 規格變更後使用 generate-api-client。驗證產生流程、執行型別檢查，並摘要任何已變更的用戶端輸出。
在 pull request 前驗證 
使用 generate-api-client 重新產生 API 用戶端、確認預期產生的檔案，並告訴我 TypeScript 型別檢查是否通過。
診斷產生失敗 
使用 generate-api-client 逐階段執行流程。找出失敗的階段，並建議最小的專案變更來修復它。

最佳實務

  • 在重新產生用戶端前先審查 OpenAPI 變更。
  • 在不受信任的儲存庫中執行產生流程前，先檢查專案套件腳本。
  • 當儲存庫預期提交產生檔案時，將產生的用戶端變更與相關後端合約變更一起提交。

避免

  • 手動編輯產生的 API 用戶端檔案，而不是變更 OpenAPI 規格或 Orval 設定。
  • 在審查依賴項與套件腳本前執行產生流程。
  • 在產生後忽略 TypeScript 錯誤。

常見問題

此 skill 是否需要 Orval？
是。它假設專案已設定 Orval，並透過前端套件腳本提供產生流程。
它預期 OpenAPI 檔案位於哪裡？
它會在執行產生流程前檢查 backend/src/main/resources/static/api-docs.yaml。
它會建立 Orval 設定嗎？
不會。它使用現有的專案設定，並專注於執行與驗證產生流程。
我可以將它用於 Claude、Codex 和 Claude Code 嗎？
可以。報告宣告支援 Claude、Codex 與 Claude Code 工作流程。
它會呼叫外部服務嗎？
在 SKILL.md 中找不到證據。文件記載的流程使用本機專案命令與本機檔案。
執行前我應該檢查什麼？
在社群或不受信任的儲存庫中工作時，請審查套件腳本、依賴項與 OpenAPI 來源。

開發者詳細資訊

作者

Crearize

授權

MIT

Skillstore 修訂

r1

版本提示

作者未聲明版本。

儲存庫

https://github.com/Crearize/ProjectTemplate/tree/main/.claude/skills/generate-api-client

引用

0519034dad657fb1f7706e0550e962beeda73fdf

維護新鮮度

2026/7/22

使用量

5 次下載 · 222 次瀏覽

檔案結構

📄 SKILL.md

Crearize 的更多技能

查看全部

相關技能

查看全部