技能 openapi-generator
📦

openapi-generator

內容修訂 r1 安全 ⚙️ 外部命令🌐 網路存取

從 API 產生 OpenAPI 規格

API 團隊需要與實際端點相符的精確規格。此技能可協助從程式碼和範例建立、改善、驗證並記錄 OpenAPI 檔案。

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

使用我的智慧代理安裝

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

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

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

Agent 可讀資源

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

Markdown 詳情 GET /skills/curiouslearner-openapi-generator.md 已簽名 manifest GET /api/skills/curiouslearner-openapi-generator/manifest 已簽名 lockfile GET /api/skills/curiouslearner-openapi-generator/lockfile

測試它

正在使用「openapi-generator」。 包含列表、建立、更新、刪除、登入和重新整理路由的小型使用者 API。

預期結果:

包含使用者結構描述、驗證、分頁、驗證規則和標準錯誤回應的結構化 OpenAPI 草稿。

正在使用「openapi-generator」。 缺少範例、描述和安全性細節的不完整規格。

預期結果:

文件改善計畫，加上範例、可重複使用元件、範圍和回應描述的修訂章節。

正在使用「openapi-generator」。 要求從 OpenAPI 檔案產生 TypeScript client 和 HTML 文件。

預期結果:

涵蓋產生器選擇、輸出資料夾、驗證步驟，以及發布前審查檢查的命令計畫。

安全審計

安全
v8 • 2026/7/5 開啟版本化報告

All static findings were adjudicated as false positives. The flagged patterns are Markdown fences, Go struct tags, sample OpenAPI URLs, documentation links, and normal API error examples; no prompt injection, exfiltration, or malicious intent was found.

1
已掃描檔案
997
分析行數
0
複核項目
0
已忽略的誤報

風險因素

⚙️ 外部命令 (24)
SKILL.md:42-48 SKILL.md:48-53 SKILL.md:53-615 SKILL.md:615-620 SKILL.md:620-683 SKILL.md:683-686 SKILL.md:686-759 SKILL.md:759-762 SKILL.md:762-796 SKILL.md:796-802 SKILL.md:802-807 SKILL.md:807-812 SKILL.md:812-838 SKILL.md:838-843 SKILL.md:843-849 SKILL.md:849-852 SKILL.md:852-873 SKILL.md:873-876 SKILL.md:876-885 SKILL.md:885-888 SKILL.md:888-894 SKILL.md:894-899 SKILL.md:899-905 SKILL.md:920-925
🌐 網路存取 (10)
SKILL.md:859 SKILL.md:62 SKILL.md:65 SKILL.md:68 SKILL.md:70 SKILL.md:72 SKILL.md:606 SKILL.md:607 SKILL.md:967 SKILL.md:968
最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。
審計單位: codex 檢視審計紀錄 →
分享與引用此報告

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

開啟版本化報告
安全評估

複製報告連結

https://skillstore.io/skills/curiouslearner-openapi-generator/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/curiouslearner-openapi-generator/security.svg)](https://skillstore.io/skills/curiouslearner-openapi-generator?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/curiouslearner-openapi-generator?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/curiouslearner-openapi-generator/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/curiouslearner-openapi-generator.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 引用

CuriousLearner. (2026). openapi-generator security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/curiouslearner-openapi-generator/audits/8

BibTeX 引用

@techreport{curiouslearner-curiouslearner-openapi-generator-2026, author = {CuriousLearner}, title = {openapi-generator security audit report (audit version 8)}, institution = {Skillstore}, year = {2026}, number = {8}, url = {https://skillstore.io/skills/curiouslearner-openapi-generator/audits/8}, 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: "openapi-generator security audit report (audit version 8)" version: "unspecified" type: report authors: - name: "CuriousLearner" date-released: "2026-07-05" url: "https://skillstore.io/skills/curiouslearner-openapi-generator/audits/8" identifiers: - type: other value: "skillstore:curiouslearner-openapi-generator:audit:8" description: "Skillstore immutable audit report identifier"

Skillstore 評分

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

你可以打造什麼

記錄現有 REST API

將路由檔案和回應範例轉換為結構化的 OpenAPI 草稿以供審查。

準備 API 參考內容

新增描述、範例、結構描述和錯誤回應，以建立可讀的 API 文件。

產生 Client SDK 工作流程

規劃用於 client、server stub 和靜態文件輸出的 OpenAPI Generator 命令。

試試這些提示

建立基本規格 
為此 REST API 產生 OpenAPI 3.0 草稿。包含路徑、方法、參數、回應和可重複使用的結構描述。
改善現有文件 
審查此 OpenAPI 檔案，並改善描述、範例、驗證規則、錯誤回應、標籤和安全性配置文件。
從程式碼映射路由 
分析這些 API 路由檔案，並產生反映端點、請求主體、查詢參數和回應結構描述的 OpenAPI 規格。
規劃產生和驗證 
建立工作流程以驗證此 OpenAPI 規格、產生 TypeScript client、建立文件，並列出所需的本機命令。

最佳實務

  • 在要求完整規格之前，提供具代表性的請求和回應範例。
  • 與 API 擁有者一起審查產生的驗證、授權和錯誤回應。
  • 在發布變更之前，於乾淨的分支中執行 OpenAPI 驗證和 client 產生。

避免

  • 不要在未檢查路由行為和敏感欄位的情況下發布產生的規格。
  • 不要在公開範例中使用假的生產 URL、token 或憑證。
  • 不要從未驗證或過時的 OpenAPI 檔案產生 SDK。

常見問題

此技能可以從程式碼建立新的 OpenAPI 檔案嗎？
可以。它可以從路由檔案和範例草擬路徑、結構描述、參數、回應和安全性章節。
它支援 Swagger 和 OpenAPI 嗎？
可以。它專注於 OpenAPI 3.0，並在常見情況下使用 Swagger 工具術語。
它可以產生 client SDK 命令嗎？
可以。它可以建議用於 client、server stub 和文件的 OpenAPI Generator CLI 命令。
它會自動執行網路請求嗎？
不會。此技能文件會參考 URL 和工具，但不需要自動網路存取。
產生的規格應該經過審查嗎？
應該。發布前請審查結構描述、驗證、授權、範例和敏感欄位。
哪些使用者最能從此技能受益？
後端工程師、平台工程師和技術寫作者可以使用它來記錄和驗證 API。

開發者詳細資訊

授權

MIT

Skillstore 修訂

r1

版本提示

作者未聲明版本。

儲存庫

https://github.com/CuriousLearner/devkit/tree/main/skills/openapi-generator

引用

02f077c174c5335e2f5d02ca15e77b70d9543e58

維護新鮮度

2026/7/18

使用量

6 次下載 · 274 次瀏覽

檔案結構

📄 SKILL.md

CuriousLearner 的更多技能

查看全部

相關技能

查看全部