360 Secure SkillHub
360 安全技能中心

Skylv Openapi Generator

核心功能是生成符合OpenAPI3.0标准的REST API接口文档。典型使用场景包括用户要求生成API文档、为新增REST接口编写文档时。通过触发词调用,输出遵循指定模板的规范内容,还提供编写小贴士辅助优化文档。

sky-lv
sky-lv
热度 41.17
最近更新 2026-05-11 17:44:40
分类:开发依赖:纯提示词应用场景:API 集成 / 代码生成

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add skylv-openapi-generator
Metadata
name
skylv-openapi-generator
slug
skylv-openapi-generator
version
1.0.0
description
Generates OpenAPI 3.0 specs from code. Creates API documentation for REST endpoints. Triggers: openapi spec, generate api doc, swagger.
author
SKY-lv
license
MIT
tags
["automation","tools"]
keywords
["automation","tools"]
triggers
openapi-generator

OpenAPI Generator

Overview

Creates OpenAPI 3.0 specifications for REST APIs.

When to Use

  • User asks to "generate API documentation"
  • Documenting new API endpoints

Template Structure

openapi: 3.0.0 info: title: My API version: 1.0.0 paths: /users: get: summary: List users parameters: - name: page in: query schema: { type: integer } responses: 200: description: Success

Tips

  • Always specify response schemas
  • Use $ref to avoid duplication
  • Group endpoints with tags
  • Add examples for request/response bodies