discover-api

API スキルの検出

API の設計、認証、実装に関する包括的なスキルに自動的にアクセスできます。

このスキルが有効になる条件

以下の作業を行うと、このスキルが自動的に有効になります。

• REST API の設計と実装
• GraphQL スキーマの設計
• API 認証（JWT、OAuth 2.0、API キー、セッション）
• API 認可（RBAC、ABAC、権限）
• レート制限とスロットリング
• API のバージョニング戦略
• エラー処理とバリデーション
• HTTP メソッド、ステータスコード、エンドポイント

利用可能なスキル

クイックリファレンス

API カテゴリーには、8 つの専門スキルがあります。

1. rest-api-design - RESTful なリソースモデリング、HTTP のセマンティクス、URL の規約
2. graphql-schema-design - GraphQL の型、リゾルバー、N+1 問題の防止
3. api-authentication - JWT、OAuth 2.0、API キー、セッション管理
4. api-authorization - RBAC、ABAC、ポリシーエンジン、権限システム
5. api-rate-limiting - トークンバケット、スライディングウィンドウ、レート制限アルゴリズム
6. api-versioning - API のバージョニング、非推奨化、後方互換性
7. api-error-handling - RFC 7807 エラー、バリデーション、標準化されたレスポンス
8. api-design-rules - API 設計に関する独自のルール 35 項目

カテゴリーの詳細をすべて読み込む

説明とワークフローの全容については、次を参照してください。

Read ../api/INDEX.md

API カテゴリーのインデックス全体が読み込まれ、以下を確認できます。

• スキルの詳細な説明
• 各スキルを使用するきっかけ
• よくあるワークフローの組み合わせ
• 関連スキルへの相互参照

特定のスキルを読み込む

必要に応じて、個々のスキルを読み込みます。

API 設計の基礎

Read ../api/rest-api-design.md Read ../api/graphql-schema-design.md

セキュリティとアクセス制御

Read ../api/api-authentication.md Read ../api/api-authorization.md

本番環境向けの強化

Read ../api/api-rate-limiting.md Read ../api/api-error-handling.md Read ../api/api-versioning.md

ルールとベストプラクティス

Read ../api/api-design-rules.md

よくあるワークフロー

新しい REST API

順序：REST 設計 → 認証 → 認可

Read ../api/rest-api-design.md # リソースモデリング、HTTP メソッド Read ../api/api-authentication.md # ユーザー認証 Read ../api/api-authorization.md # アクセス制御

新しい GraphQL API

順序：GraphQL スキーマ → 認証 → 認可

Read ../api/graphql-schema-design.md # スキーマ設計、リゾルバー Read ../api/api-authentication.md # ユーザー認証 Read ../api/api-authorization.md # フィールドレベルの権限

API の強化

順序：レート制限 → エラー処理 → バージョニング

Read ../api/api-rate-limiting.md # 不正利用を防止 Read ../api/api-error-handling.md # エラーを標準化 Read ../api/api-versioning.md # 進化を管理

API スタック全体

ゼロからの完全な実装：

1. 設計フェーズ

Read ../api/rest-api-design.md

2. セキュリティフェーズ

Read ../api/api-authentication.md Read ../api/api-authorization.md Read ../api/api-rate-limiting.md

3. 本番環境への準備

Read ../api/api-error-handling.md Read ../api/api-versioning.md

スキルの選択ガイド

REST API のスキルを選ぶ場合：

• 従来型の Web サービスを構築するとき
• シンプルな CRUD 操作が必要なとき
• モバイルアプリや SPA を扱うとき
• キャッシュと HTTP のセマンティクスが必要なとき

GraphQL のスキルを選ぶ場合：

• クライアントが柔軟なデータ取得を必要とするとき
• 過剰取得や取得不足を減らすとき
• 集約レイヤーを構築するとき
• API に強い型付けが必要なとき

認証と認可の違い：

• 認証（api-authentication.md）：あなたは誰ですか？（ログイン、JWT、OAuth）
• 認可（api-authorization.md）：何ができますか？（権限、RBAC）

本番環境での考慮事項：

• パブリック API には必ずレート制限を実装してください
• 最初からバージョニングを使用してください
• 早い段階でエラーレスポンスを標準化してください

他のスキルとの連携

API スキルは、一般に以下のスキルと組み合わせて使用します。

データベーススキル（discover-database）：

• API エンドポイント → データベースクエリ
• API サーバーのコネクションプーリング
• API パフォーマンス向上のためのクエリ最適化

テストスキル（discover-testing）：

• API エンドポイントの統合テスト
• API コンシューマーのコントラクトテスト
• API パフォーマンスの負荷テスト

フロントエンドスキル（discover-frontend）：

• API クライアントライブラリ
• データ取得パターン
• UI でのエラー処理

インフラスキル（discover-infra、discover-cloud）：

• API のデプロイ戦略
• 負荷分散とスケーリング
• API ゲートウェイとプロキシ

使用方法

1. 自動有効化：Claude Code が API 関連の作業を検出すると、このスキルが自動的に読み込まれます
2. スキルを確認する：カテゴリ全体の概要を確認するには、Read ../api/INDEX.md を実行します
3. 特定のスキルを読み込む：上記の bash コマンドを使用して、個別のスキルを読み込みます
4. ワークフローに従う：一般的な API パターンには、推奨される手順を使用します
5. スキルを組み合わせる：包括的に対応するには、複数のスキルを読み込みます

段階的な読み込み

このゲートウェイスキル（約 200 行、約 2K トークン）を使うと、段階的に読み込めます。

• レベル 1：ゲートウェイが自動的に読み込まれます（現在ここです）
• レベル 2：カテゴリ全体の概要を確認するには、INDEX.md（約 3K トークン）を読み込みます
• レベル 3：必要に応じて、個別のスキル（各約 2～3K トークン）を読み込みます

合計コンテキスト：2K + 3K + スキル（複数可）＝ 5～10K トークン。インデックス全体を読み込む場合の 25K 以上に比べて少なくなります。

クイックスタートの例

「ブログ用の REST API を設計する」： Read ../api/rest-api-design.md

「API に OAuth 認証を追加する」： Read ../api/api-authentication.md

「ロールベースのアクセス制御を実装する」： Read ../api/api-authorization.md

「API の不正利用を防止する」： Read ../api/api-rate-limiting.md

「API のバージョニング戦略を設計する」： Read ../api/api-versioning.md

次のステップ：カテゴリの詳細をすべて確認するには Read ../api/INDEX.md を実行するか、上記の bash コマンドを使って特定のスキルを読み込みます。