netlify-ai-gateway
作者 netlify面向 Netlify AI Gateway 的 netlify-ai-gateway 技能指南。了解安装与使用基础、支持的模型、SDK 配置，以及在 Netlify 应用中进行后端开发的常见模式。
该技能得分 78/100。它适合收录到目录中，因为它给出了明确的使用触发场景、具体的配置步骤，以及可直接上手的 SDK 示例，帮助用户使用 Netlify AI Gateway，而不是停留在泛泛的提示词层面。主要限制在于它的适用范围偏窄，而且前提是用户已经明确想使用 Netlify 的 gateway，因此它实用但不算通用。
- 触发场景和目标清晰：适合在通过 Netlify AI Gateway 为应用添加 AI 能力，或选择/切换 AI 模型时使用。
- 配置说明具有实操价值：解释了如何在站点中启用 AI、自动设置 `OPENAI_BASE_URL`，以及为何无需提供商 API key。
- 执行示例具体：展示了 provider SDK 的用法，并提醒只应使用 Available Models 部分列出的模型。
- 仓库证据中没有提供安装命令、支持文件或参考文档，因此实际采用主要还是要依赖 `SKILL.md`。
- 模型可用性有约束；该技能明确提示，使用不受支持的 provider 模型会导致运行时错误。
netlify-ai-gateway 技能概览
netlify-ai-gateway 技能能做什么
netlify-ai-gateway 技能可以帮助你通过 Netlify AI Gateway，把 Netlify 上的应用连接到 AI 模型，而不是为每个提供商单独直连配置。它最适合用在你需要添加 AI 功能、切换提供商，或者在整个 Netlify 站点上统一接入方式、又不想维护多套 API keys 的场景。
适合谁使用
这个 netlify-ai-gateway 技能很适合后端开发、服务端应用代码，以及已经在 Netlify 上部署的团队。如果你希望把提供商配置保持简单，同时继续使用 OpenAI 或 Anthropic 这类熟悉的 SDK，它尤其有用。
安装前最需要关注什么
安装前最关键的判断点是模型支持范围：AI Gateway 并不会暴露某个提供商的全部模型。如果你选了不受支持的模型，应用会在运行时失败。也就是说，这个技能更看重模型选型是否正确、环境是否配置到位，而不是提示词写得多花哨。
如何使用 netlify-ai-gateway 技能
先安装，再优先阅读这些文件
先通过你的 skills 工具链执行 netlify-ai-gateway install 流程，然后优先打开 SKILL.md。如果你是把这套流程接入已有代码库，也要先检查应用的 Netlify 配置和仓库里的 AI 集成文件，再改代码。在这个仓库里，SKILL.md 是唯一的源文件，所以它就是 netlify-ai-gateway usage 的主导指南。
把模糊目标变成可用的提示词
这个技能最有效的提示词，会明确写出提供商 SDK、应用运行时，以及模型需要完成的具体任务。比如：“在一个 Next.js 后端路由中添加 Netlify AI Gateway，使用 OpenAI SDK，保留 Netlify 托管的认证，只使用受支持的模型来实现一个简短的 chat completion 端点。” 这样技能就有足够上下文去选择兼容方案，而不是靠猜。
按技能预期的实现路径来走
这个技能的设计思路是：使用标准的提供商 SDK，由平台注入 Netlify 的 gateway URL。实际操作时，你应该：
- 在 Netlify 站点上启用 AI。
- 确认部署环境中已经存在与 gateway 相关的环境变量。
- 安装你真正要调用的 provider SDK。
- 使用技能允许模型说明里列出的模型。
- 在已部署的 Netlify 环境中验证请求是否成功，而不只是本地能跑通。
减少可以避免的输出错误
对于 netlify-ai-gateway for Backend Development，要把后端框架、路由或 handler 类型、以及目标提供商告诉模型。还要说明你需要的是 chat、streaming，还是一个简单的 completion。这些细节会改变代码结构，也能减少那种“能编译、但不适合你的应用”的示例。
netlify-ai-gateway 技能 FAQ
netlify-ai-gateway 只适用于部署在 Netlify 的应用吗？
是的，这才是它最自然的使用场景。这个技能是围绕 Netlify 的托管 gateway 和环境配置设计的，因此当你的应用已经运行在 Netlify 上，或者正在迁移到 Netlify 时，它的价值最高。
我需要 provider API keys 吗？
通常不需要。netlify-ai-gateway 的一个核心优势，就是由 Netlify 负责认证，所以你不必像直接集成 SDK 那样，把 provider keys 接进应用里。
这和普通 prompt 有什么区别？
普通 prompt 可能只会给你一段通用的 AI 集成代码。netlify-ai-gateway 技能应该把你引导到 Netlify 专属配置、受支持模型限制，以及正确的 SDK 模式上，从而降低部署时才暴露问题的概率。
这个技能适合新手吗？
如果你已经知道自己要做哪种 AI 功能，那它是适合的。可如果你还在不同 provider 之间犹豫，或者想从零学习 AI 应用架构，那它就没那么新手友好，因为这个技能默认你已经具备一定的后端和部署上下文。
如何改进 netlify-ai-gateway 技能
先直接说清楚具体使用场景
最强的输入一定是具体的：“添加一个 support chat 端点”、“把直接调用 OpenAI 改成 Netlify AI Gateway”、“把一个硬编码模型替换成受支持的模型用于 summarization”。像“让 AI 能用起来”这种模糊请求，通常只会得到泛泛的集成建议。
先把模型和约束条件说清楚
想让 netlify-ai-gateway usage 更准确，就要提前告诉技能你需要的是 OpenAI、Anthropic，还是 Google 的 SDK 模式，以及你是否必须避免 streaming、需要加日志，或者要把响应控制在某个延迟预算以内。模型选择和约束条件，正是大多数集成出错的地方。
尽早确认受支持模型边界
最大的失败模式，就是默认每个 provider 的模型都可用。在实现之前，先根据技能里的 available-model 指引核对候选模型，如果需要就调整提示词。这样能节省时间，也能避免生成看起来没问题、但到了生产环境就会坏掉的代码。
优化部署细节，而不只是代码
如果第一版已经接近目标，就补上真实的 Netlify 环境名、function 路径和部署目标来继续完善。这些细节能帮助技能生成更贴合你应用实际后端开发设置的代码，而不是一个泛化示例。