Skills: ドキュメント生成スキル

良いドキュメントの条件：
├── 正確：実際のコードの振る舞いと一致
├── 完全：すべての公開インターフェースをカバー
├── 簡潔：無駄がなく、一文一文に情報価値がある
├── タイムリー：コードの変更と同期して更新
└── アクセシブル：フォーマットが統一され、検索しやすい

## API ドキュメント生成フロー
1. Glob でルート/コントローラーファイルを見つける
2. 各インターフェース定義を読み込む
3. 抽出：パス、メソッド、パラメータ、戻り値、例外
4. モジュールごとに整理して出力

## POST /api/users

### 説明
新規ユーザーを作成

### リクエストパラメータ
| パラメータ | 型 | 必須 | 説明 |
|:----------|:-----|:---------|:------------|
| name | string | はい | ユーザー名 |
| email | string | はい | メールアドレス |

### レスポンス
| フィールド | 型 | 説明 |
|:------|:-----|:------------|
| id | integer | ユーザー ID |
| name | string | ユーザー名 |

### エラー
| ステータスコード | 説明 |
|:------------|:------------|
| 400 | パラメータ検証失敗 |
| 409 | メールアドレスが既に存在 |

## README 情報収集
1. Glob：プロジェクトファイルを検出（package.json/go.mod/pyproject.toml）
2. Read：設定ファイルから技術スタック、依存関係、スクリプトを読み取り
3. Grep：エントリファイル、環境変数、設定項目を検索
4. Bash：git log --oneline -10 で最近の変更を取得

# プロジェクト名

> 一行説明

## クイックスタート

### 前提条件
- Node.js >= 18
- PostgreSQL >= 14

### インストール
```bash
npm install
cp .env.example .env
npm run dev

---

## 4. チェンジログ生成

### (1) Git から変更を抽出

```bash
# バージョン間の変更を取得
git log v1.1.0..v1.2.0 --oneline
git log v1.1.0..v1.2.0 --format="%s" --no-merges

## v1.2.0 (2026-08-15)

### ✨ 新機能
- ユーザーエクスポート機能を追加 (#42)
- ダークモードをサポート (#45)

### 🐛 バグ修正
- ログインタイムアウト問題を修正 (#38)
- データソートエラーを修正 (#41)

### 💔 破壊的変更
- API /users レスポンスフォーマット変更、name フィールドを username にリネーム

---
name: doc-generator
description: "ワンクリックフルプロジェクトドキュメント生成"
triggers:
  - keyword: "gen-docs|generate-docs|ドキュメント生成"
tools:
  - Read
  - Grep
  - Glob
  - Write
  - Bash
---