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. 02评审 429 响应和重试指引
  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