# swagger2-doc-skills

**Repository Path**: swagger2-doc/swagger2-doc-skills

## Basic Information

- **Project Name**: swagger2-doc-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-06
- **Last Updated**: 2026-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# swagger2-doc-skills

AI Skills for swagger2-doc-parser - 让 AI 编程助手通过 Skills 自动生成 API 客户端代码。

## 技能列表

### `swagger2-doc-gen` - 生成 API 客户端代码

根据 Swagger/OpenAPI 文档为指定平台生成 API 客户端代码。

**参数：**
- `doc` (string): Swagger 文档 URL 或本地 JSON 文件路径
- `platform` (string): 目标平台，可选: `flutter` `react-ts` `react-native` `vue` `miniprogram` `uniapp` `java-springboot` `golang-gin` `python-flask` `nodejs-express`
- `output` (string, 可选): 输出目录，默认 `./api`

**示例：**
```
使用 swagger2-doc-gen 技能，doc=http://localhost:8080/api-json, platform=flutter, output=./lib/controllers
```

### `swagger2-doc-fetch` - 获取 Swagger 文档

从远程 URL 获取 Swagger API 文档并保存到本地。

**参数：**
- `url` (string): Swagger API 文档 URL
- `output` (string, 可选): 保存路径，默认 `./api-doc.json`

## 使用方式

1. 在 AI 编程助手中描述需求
2. 指定目标平台和 Swagger 文档源
3. 技能会调用 swagger2-doc-parser 生成代码

## 配置要求

确保已安装 swagger2-doc-parser：

```bash
npm install -g swagger2-doc-parser