netlify-frameworks

netlify-frameworks 技能概览

netlify-frameworks 技能是一份部署指南，帮助你把现代 Web 框架正确运行在 Netlify 上，减少比通用提示更高的试错成本。对于要部署或排查 Vite/React、Astro、TanStack Start、Next.js、Nuxt、SvelteKit 或 Remix 的项目，而且需要弄清 Netlify 对各自框架的具体要求时，它尤其有用。

它解决的是什么问题

这个 netlify-frameworks skill 关注的是实际工作：把框架项目变成可用的 Netlify 部署，尤其是在涉及 SSR、API 路由、middleware 或平台原语时。它能帮助你判断自己需要的是 adapter、plugin，还是只要静态托管就够了。

什么时候适合用

当你需要 netlify-frameworks for Deployment、框架特定配置、本地开发与线上环境尽量一致，或者需要把框架的服务端能力转换成 Netlify Functions 和 Edge Functions 时，就很适合用它。它特别适合你已经熟悉框架本身，但不确定 Netlify 这一层该怎么接的时候。

它有什么不同

它的核心价值是实用的兼容性指导，而不是抽象的平台理论。它会给出框架识别线索、adapter/plugin 模式和参考路径，帮助你从“我的应用应该能部署”推进到“这是可以直接尝试的 Netlify 具体配置”。

如何使用 netlify-frameworks 技能

正确安装并加载

在进行 netlify-frameworks install 时，先把这个技能加入你的 skills 工作流，然后先打开 SKILL.md。把这些参考内容当成实现说明，而不是可有可无的阅读材料，因为真正决定结果的配置细节通常都在框架专属文件里。

提供可直接部署的输入

最好的 netlify-frameworks usage 往往从三个信息开始：你的框架、输出模式，以及当前失败或尚未配置的部分。比如：“在 Netlify 上部署一个带 image optimization 和 middleware 的 Next.js App Router 应用”就远比“帮我部署 Next.js”更有效。

先读对的文件

先看 SKILL.md，然后跳到对应的参考文件，比如 references/nextjs.md、references/astro.md、references/tanstack.md 或 references/vite.md。这个仓库的结构就是为了快速按框架查找，所以第一轮应该是：识别框架，阅读对应参考，再检查你自己项目里的 build 或 routing 细节。

把粗略目标变成高质量提示词

这个技能的好提示词应该写清楚框架、仓库形态和部署约束。比如：“我有一个 Vite + React SPA，使用 React Router，并且有一个 /api/hello function。请给出 Netlify 配置、重定向规则和本地开发设置。” 这样的提示能给技能足够上下文，从而产出可部署的答案，而不是泛泛的解释。

netlify-frameworks 技能常见问题

这只适用于带 SSR 的框架应用吗？

不是。netlify-frameworks 同时覆盖静态输出和支持服务端的框架。如果你的应用纯静态，它的主要价值是帮你确认不需要额外的 Netlify 运行时组件。

如果我会看 Netlify 文档，还需要这个技能吗？

如果你已经很熟悉框架和 Netlify 的部署模型，也许不需要。netlify-frameworks guide 更适合用在你想更快地从“选了哪个框架”走到“怎么部署成功”这条路径上，尤其是在多个框架、多个 adapter 约定并存的时候。

它适合初学者吗？

适合，前提是你能识别自己的框架和 build command。若你还不清楚应用是 SPA、SSR、hybrid 还是 edge-aware，它就没那么友好，因为这些判断会决定应该看哪条参考路径。

什么时候不该用它？

如果你部署的是一个没有框架特定行为的纯静态站点，或者问题与框架集成无关，比如内容流水线、CMS schema 或一般 JavaScript bug，就不要用 netlify-frameworks。

如何改进 netlify-frameworks 技能

提供准确的框架形态

最大的质量提升来自明确说明应用是静态、SSR、hybrid 还是 API-heavy。比如：“Astro 的 hybrid 模式，带一个 API route 和一个预渲染的 marketing site” 就比“Astro on Netlify”更有操作性。

补充构建和路由约束

如果你的部署依赖重定向、图片处理、表单，或者特定的 publish directory，一开始就说清楚。只有知道你是否需要 SPA fallback、function routing 或 adapter 输出校验时，这个技能才能给出更准确的建议。

直接要你真正需要的产物

如果你想要可以直接粘到仓库里的内容，就明确要求 netlify.toml、框架配置，以及最少必要的代码改动。如果你想先排查问题，就先让它列出最可能的故障点。这样能让答案更聚焦于你下一步真正要应用的东西。

用第一次部署结果继续迭代

第一次运行后，把准确症状反馈回来：构建日志报错、路由缺失、SSR 不匹配，或者 function 找不到。这样能最快提升 netlify-frameworks usage 的效果，因为下一轮回答就能从通用配置建议，收敛到具体的 adapter 或配置边界问题。