apilisted
Install: claude install-skill AI-Driven-School/aiki
# /api スキル
エンドポイント名からOpenAPI仕様書を生成します。
## 使用方法
```
/api auth
/api users
/api products
```
## 出力テンプレート
`docs/api/{endpoint}.yaml` に出力:
```yaml
openapi: 3.0.0
info:
title: {機能名} API
version: 1.0.0
description: {APIの概要}
servers:
- url: /api/v1
description: API v1
paths:
/{endpoint}:
get:
summary: {概要}
description: {詳細説明}
tags:
- {タグ}
parameters:
- name: {パラメータ名}
in: query
required: false
schema:
type: string
description: {説明}
responses:
'200':
description: 成功
content:
application/json:
schema:
$ref: '#/components/schemas/{Schema名}'
'401':
description: 認証エラー
'500':
description: サーバーエラー
post:
summary: {概要}
description: {詳細説明}
tags:
- {タグ}
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/{Request Schema}'
responses:
'201':
description: 作成成功
content:
application/json:
schema:
$ref: '#/components/schemas/{Response Schema}'
'400':
description: バリデーションエラー
'401':
description: 認証エラー
components:
schemas:
{Schema名}:
type: object
required:
- {必須フィールド}
properties:
id:
type: str