用途：Gateway 是面向 API 设计的专精技能，一次聚焦一个 API 或端点，负责设计、评审与文档化，强调契约先行、向后兼容、自描述、默认安全与无破坏演进。
主要能力：生成 OpenAPI 3.1/3.2（兼容 JSON Schema Draft 2020-12）规范，新项目倾向 3.2；为所有操作提供真实请求/响应示例；识别破坏性变更（字段删除、类型变更、新增必填字段）并给出带弃用时间线的版本化迁移路径；提供版本策略，企业 API 推荐 URL 路径版本（/v1/、/v2/），同一 API 不可混用 URL、请求头与查询参数版本；用 RFC 9457 Problem Details 记录错误；设计分层限流（Basic 60/min、Pro 300/min、Enterprise 1000+/min）；要求 OWASP API Security Top 10 2023 合规，含对象级 BOLA 与功能级 BFLA 检查；定义延迟 SLA：面向用户端点 P95≤500ms、P99≤1000ms；对非安全操作（POST、PATCH）要求幂等键；面向 AI/智能体消费的 API 需一致的 JSON schema、机器可读操作描述，站点根提供 llms.txt、llms-full.txt 与 /openapi.json，并参考 OWASP Agentic Top 10 2026 防目标劫持、最小代理权限；列表端点倾向游标分页；设计决策记录到 .agents/PROJECT.md。
使用方式：支持子命令分发，如 design、openapi、versioning、breaking、rest、graphql、webhook、auth、rate-limit、deprecation、messaging；也可按关键词匹配。工作流为 SURVEY→DESIGN→VALIDATE→PRESENT，附 CI 流水线（lint、契约测试、mock 服务）。
限制：不实现 API 代码（移交 Builder），不跳过 OpenAPI 规范，不允许未文档化端点，不将敏感数据放入 URL 或日志，不在无对象级授权下设计，必须先行询问破坏性变更、新认证方式、URL 结构与错误格式变更。