netlify-edge-functions

netlify-edge-functions 技能概览

这个技能是用来做什么的

netlify-edge-functions 技能是一本实用指南，帮助你构建 Netlify Edge Functions：在 Netlify 边缘网络上运行的轻量级代码，用于快速处理请求、路由、重写、鉴权检查、地理位置逻辑和响应塑形。它最适合那些已经明确需要低延迟后端行为的读者，帮助他们把 netlify-edge-functions 技能真正落地，而不只是停留在概念说明。

什么时候最适合用它

当 Backend Development 任务依赖入站请求、用户位置、请求头、cookie 或基于路径的逻辑时，适合使用 netlify-edge-functions。它非常适合中间件式行为、A/B 路由，或者靠近用户的小型决策层。对于重计算、长时间运行的任务，或者更适合普通 server runtime 的应用逻辑，它的价值就没那么大。

它有什么不同

这份 netlify-edge-functions 指南的核心价值在于实际部署上下文：Deno runtime 的预期、context.next() 的流转方式、netlify/edge-functions/ 下的文件放置规则，以及由配置驱动的路由。这能帮助你避开常见的落地错误，比如把代码写给了错误的 runtime，或者在应该使用 edge 行为的场景里套用 serverless 模式。

如何使用 netlify-edge-functions 技能

安装并找到权威来源

先在你的工作区里按 netlify-edge-functions 的安装流程安装这个 skill package，然后第一时间阅读 SKILL.md。在这个仓库里，没有配套的 rules/、resources/ 或 scripts/ 文件夹，所以主要实现指引都集中在 skill 文件本身。也就是说，最快的做法是把 SKILL.md 当作权威来源，并按你的仓库结构去适配它。

把模糊目标转成有用的提示词

高质量输入要具体说明路由、行为和决策点。比如不要只说“构建一个 edge function”，而要说：“创建一个 Netlify Edge Function：把 EU 访客重定向到 /eu，跳过 /api/public/*，并在缺少 session cookie 时返回 401。” 这样 netlify-edge-functions 技能才有足够信息生成正确的路径配置、请求检查和响应处理。

先读会影响实现的部分

先看语法示例，再看 config 对象，最后看 middleware 模式。这三部分覆盖了 netlify-edge-functions 使用中最关键的决策：文件放在哪里、如何匹配请求、以及如何通过 context.next() 继续传递控制权。如果你的项目依赖请求头、cookie 或地理位置，那在写提示词或代码之前，先读这些部分。

更容易产出好结果的实用工作流

使用这个技能时，建议按这个顺序来：先定义请求匹配，再定义 edge 决策，然后定义兜底响应，最后补充缓存或错误行为。比如：“匹配 /pricing/*，检查国家地区，重写到本地化内容，如果 edge 逻辑失败就使用 onError: "bypass"。” 这个顺序更贴近 edge 代码的真实结构，也能减少首次生成后的来回修改。

netlify-edge-functions 技能常见问题

这个技能只适合有经验的 Netlify 用户吗？

不是。只要你已经理解基本的 web request/response 概念，netlify-edge-functions 技能对初学者也很友好。最重要的是你要有清晰的路由级目标。初学者通常不是卡在语法上，而是卡在任务到底该不该放到 edge 上。

它和普通的 edge functions 提示词有什么不同？

通用提示词往往会漏掉让 edge 代码在 Netlify 上真正生效的部署细节：文件位置、支持的扩展名、配置结构，以及 middleware 行为。netlify-edge-functions 技能更适合那些需要安装导向、并且可以直接应用到项目中的指导，而不是靠猜运行时规则。

什么时候不该用 netlify-edge-functions？

不要把这个技能用在 CPU 密集型处理、队列任务、数据汇总，或者需要长生命周期 Node.js 环境的工作流上。如果你的任务主要是数据库编排，或者是不依赖请求时决策的应用逻辑，标准 backend 或 serverless function 通常更合适。

它和更广泛的 Netlify 生态是否匹配？

是的，尤其当你的应用已经在使用 Netlify 的路由和部署约定时更是如此。netlify-edge-functions 指南最有价值的地方在于：edge 行为可以和静态内容、重定向或 serverless functions 并存，同时把快速的请求时逻辑与更重的后端工作清晰分开。

如何改进 netlify-edge-functions 技能

给技能真实的路由规则

提升质量最明显的一步，是把匹配条件写准确：路径、方法、排除规则和兜底行为都要明确。不要只说“保护站点”，而要说“保护 /dashboard/*，允许 /dashboard/login，当 session cookie 不存在时重定向到 /login”。精确的路由输入会让生成出来的 netlify-edge-functions 用法可靠得多。

明确 edge 应该读取和修改什么

当任务明确指出要读取哪些请求数据、修改哪些响应内容时，edge code 的效果最好。告诉技能它应该检查 headers、cookies、query params 还是 geolocation，以及应该 rewrite、redirect、short-circuit，还是调用 context.next()。这样能减少歧义，并改善最终的控制流。

留意常见实现错误

最常见的失败模式，是把 edge runtime 当成通用服务器来用。如果你的提示词要求文件系统访问、Node 专属 API，或者大而全的 framework setup，输出就会偏离 netlify-edge-functions 的最佳实践。请求应尽量聚焦在请求时逻辑上；只要路由行为重要，就要明确要求配置对象。

通过收紧 edge 决策来迭代

如果第一次结果太笼统，就一层一层收紧：先定路由匹配，再定鉴权规则，然后定本地化规则，最后补缓存或错误处理。这是改进 netlify-edge-functions 技能输出最有效的方式，因为它和函数的配置与执行方式是一致的。