mcpField
A
api-rate-limit-quota-review

api-rate-limit-quota-review

github.com/sylphxai開発144 回インストール今日更新
リポジトリ

api-rate-limit-quota-review について

API のレート制限やクォータに関する検討を、判断、担当者、指標、復旧手順を含む成果物にまとめるスキルです。API チームが制限方針と開発者向け契約を定義する際に役立ちます。

主な機能

  1. 01制限、クォータ、ゲートの分類
  2. 02単位、ヘッダー、エラー形式の定義
  3. 03ダッシュボードとアラートの計画
  4. 04判断表とイベントスキーマの作成
  5. 05移行とサポート経路の検討

活用シーン

  1. 01新しい API の制限設計
  2. 02429 応答と再試行案内のレビュー
  3. 03既存開発者向けクォータ変更の計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sylphxai/skills --skill api-rate-limit-quota-review

インストール後、Claude Code で/api-rate-limit-quota-reviewを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yamlreferences/api-rate-limit-quota-patterns.md

詳細

API レート制限とクォータのレビュー

このスキルを使うと、API のクォータ、レート制限、公正利用、開発者エクスペリエンス、課金との整合性、不正利用対策に関する質問を、担当者、ゲート、メトリクス、復旧手順を含む具体的な成果物に変換できます。

ワークフロー

  1. API の利用者、認証主体、エンドポイントのコスト、重要度、テナントへの影響範囲、料金プラン、不正利用のパターンを特定します。
  2. references/api-rate-limit-quota-patterns.md を読みます。
  3. レート制限、クォータ、同時実行数の上限、ペイロードの上限、支出上限、公正利用のレビュー、利用権限のゲートを区別します。
  4. 制限単位、ヘッダー、エラー形式、再試行とバックオフ、ダッシュボード、アラート、アップグレード手順、サポートによる例外措置、移行ポリシーを定義します。
  5. クォータモデル、状態遷移、エンドポイントの判断表、イベントスキーマ、開発者向け告知チェックリストを作成します。

使用しない場合

  • このスキル固有の成果物要件がなくてもベースモデルが対応できる一般的なアドバイスには使用しないでください。

ガードレール

  • エンドポイントのコスト、テナント規模、不正利用リスクが大きく異なる場合に、単一のグローバルな制限を使用しないでください。
  • 安定したヘッダー、再試行の案内、ドキュメント、可観測性を伴わない曖昧な 429 エラーを返さないでください。
  • クォータによって課金、利用権限、セキュリティ、テナント分離の制御を回避できないようにしてください。
  • 移行の告知やサポート窓口を設けずに、既存の開発者に対する制限を変更しないでください。

出力形式

API context:
Principal / endpoint cost / tenant blast radius:

Limit and quota plan:
| Area | Decision | Evidence | Risk | Owner |
| --- | --- | --- | --- | --- |

Developer contract:
- <item> -> <policy, metric, edge case, support note>

Override and migration policy:
- <trigger> -> <action, communication, owner>

コメント

Markdown 対応