Agent Skills
返回列表
🔒

API 网关落地指南(Kong)

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kunlun-api-gateway-deployment-guide。

技能介绍

问题在哪

把 Kong 当作 API 网关落地时,常见问题不是「会不会装插件」,而是:路由与上游怎么划界、鉴权限流放哪一层、多环境配置如何对齐,以及上线前后评审与排错缺乏统一清单。团队各自摸索时,方案文档缺背景与风险,PR 里安全与边界问题容易被风格讨论淹没。

技能如何帮你落地

本技能把通用工程能力接到 API 网关落地(Kong) 场景:用触发词进入对应模式,按结构化模板出交付物。

  • 技术方案设计:输入需求与约束(流量规模、是否多集群、现有认证体系),产出含背景、目标、选型对比与风险的方案骨架。
  • 代码评审:对网关相关 diff/PR 按正确性、安全、可维护性分级,输出阻断/建议/可选意见及理由。
  • 调试排错:结合报错、日志与上下文,走「稳定复现 → 隔离变量 → 看证据 → 假设验证」的定位树。
  • 架构权衡:在 Kong 与替代方案或其它网关形态之间,按场景与规模给利弊、适用边界与成本表。
  • API 设计 / 工程规范:围绕路由、契约、错误码与反模式清单,对齐 RESTful 与网关侧最佳实践。

核心工作流在 SKILL 中固定为两套:代码评审(先意图与正确性,再安全)与 线上排错(先复现再改代码)。听到「评审」「方案」「又报错了」「用 A 还是 B」等触发词即可路由到对应能力,多个诉求可组合使用。

边界与注意点

技能提供方法论、模板与检查清单,不替代你对生产变更的最终决策;涉及密钥或凭证仅给脱敏示例。不接入付费服务或外部账号,输出需你结合自家环境与合规要求微调。

使用场景

  • 新服务要上 Kong:要写一份含鉴权、路由拆分与多环境差异的技术方案
  • 网关插件或路由规则 PR 待合并:需要按安全与边界条件做分级评审清单
  • 生产环境 Kong 返回 502/超时:有日志片段,要按复现与隔离步骤定位上游或配置问题
  • 在 Kong 与 Nginx/云厂商网关之间选型:要按 QPS 与团队运维能力列利弊表

适合人员

  • 后端工程师:负责 Kong 路由与上游配置,要在上线前补齐评审与安全检查项
  • DevOps / 平台同学:维护多集群 Kong,需要排错工作流与配置对齐的模板
  • 技术负责人:网关层架构未定,要在方案里写清选型理由、风险与回滚路径
  • 全栈或小团队主程:既要定 REST 契约又要写网关侧规范,希望用同一套清单减少联调扯皮