netlify-deploy

netlify-deploy 技能概览

netlify-deploy 是一个面向部署的技能，专门用于借助 Netlify CLI 将 Web 项目发布到 Netlify。它最适合想要从本地仓库一路走到预览或生产 URL 的用户，尤其是在项目需要先完成关联、认证，或者在部署前先检查构建配置时。

它要解决的核心任务很直接：把真实项目部署出去，而且比一个泛泛的“deploy to Netlify”提示更少试错。netlify-deploy 技能适合在你需要判断是关联已有站点、新建站点，还是先跑预览时使用。它尤其适合重视 netlify.toml、框架检测，以及避免第一次生产部署就翻车的场景。

netlify-deploy 技能的用途

当任务涉及在 Netlify 上托管、发布、预览或更新站点时，用 netlify-deploy。它适用于静态站点、SPA 前端，以及 Netlify 可以通过配置自动识别或手动覆盖的框架构建。这个技能不只是“运行一个命令”；它是一套部署工作流，会先检查认证、站点关联和发布设置，再推送到线上。

什么时候这个技能特别适合

如果你需要以下场景，优先选择这个 netlify-deploy skill：

• 从本地仓库完成第一次 Netlify 初始化
• 在正式发布前先做预览部署供评审
• 基于已知构建输出目录进行生产部署
• 帮助读取或调整 netlify.toml
• 在站点尚未关联时也能继续推进的路径

安装前最该关注什么

仓库中的证据支持的是一条真实可执行的部署流程：认证检查、link/init 决策、预览与生产命令，以及配置引用。这意味着，如果你想减少假设、让部署步骤更清晰，这个技能很有价值。要是你只是想临时跑一个命令，而且已经非常清楚自己的 Netlify 配置，那么它提供的额外引导可能就没必要了。

如何使用 netlify-deploy 技能

先安装，再读对文件

使用下面的命令执行 netlify-deploy install 步骤：

npx skills add openai/skills --skill netlify-deploy

安装完成后，先看 SKILL.md，再检查 references/cli-commands.md、references/deployment-patterns.md 和 references/netlify-toml.md。同时也要查看 agents/openai.yaml，了解默认的部署意图。这些文件会告诉你最实用的路径：先认证，再 link 或 init，然后用正确的输出目录部署。

把模糊目标变成可用提示词

当你的请求不只是“deploy this”时，netlify-deploy usage 才会真正更好用。有效输入通常会说明：

• 仓库或当前目录
• 这是新站点还是已有的 Netlify 站点
• 目标是预览还是生产
• 已知的构建命令和发布目录
• 框架信息，例如 Next.js、Vite、Astro 或 SvelteKit
• 任何认证或沙箱限制

示例提示词：
“Use the netlify-deploy skill to deploy this Vite app from the current directory to a preview URL first, confirm the publish directory is dist, and tell me if netlify.toml needs changes before production.”

按 Netlify 真正需要的流程来走

这个仓库围绕一条小而关键的决策链做了优化：

1. 先检查 npx netlify status
2. 需要的话用 npx netlify login 登录
3. 用 npx netlify link 或 npx netlify init 关联已有站点或创建新站点
4. 用 npx netlify deploy 做预览部署
5. 用 npx netlify deploy --prod 做生产部署

想要更稳的结果，最好直接告诉技能：站点是否已经存在，以及你想要的是安全预览还是正式上线。这样可以避免猜测，也能帮助它在 deploy、link 和 init 之间做正确选择。

给技能它能用得上的配置线索

如果你的构建输出路径不标准，请明确写出 publish 路径。如果框架识别错了，也要说明目标框架和构建命令。例如：“Builds with npm run build, outputs to build, and should deploy from the repo root.” 这种细节比“它不工作”更有价值。

netlify-deploy 技能 FAQ

使用 netlify-deploy 需要 Netlify 经验吗？

不需要。netlify-deploy skill 会跟着认证和 link/init 流程走，所以对新手也友好。你仍然需要一个能正常运行的本地项目和 Netlify 账号，但不必先把 CLI 全背下来。

它和直接让模型帮你部署有什么不同？

有区别。泛化提示词经常会跳过认证、站点关联和 netlify.toml 检查。netlify-deploy 更适合你需要一条符合 Netlify 真实 CLI 行为的部署路径时使用，也适合你希望代理在缺少部署信息时主动追问，而不是自行编造。

什么时候不该用这个技能？

如果你不是部署到 Netlify、项目根本没有可构建的 Web 应用，或者你已经有完整脚本化的 CI/CD 流程，只差一个命令，那就不必用 netlify-deploy。当你无法提供仓库访问、构建上下文或认证信息时，它也不适合。

第一次运行时会发生什么？

可以预期技能会先检查认证，判断站点是否已关联，并在生产部署前暴露构建或发布问题。如果项目需要调整配置，第一次运行可能只会产出一个预览部署，或者直接给出修复清单，而不是正式上线。这通常正是 netlify-deploy for Deployment 最合适的结果。

如何改进 netlify-deploy 技能

先把构建事实说清楚

提升效果最大的办法，是一开始就把准确的构建行为告诉技能。请包含命令、输出目录和框架。例如：“npm run build outputs to dist, and the app is a Vite SPA with client-side routing.” 这样可以帮助 netlify-deploy 避免错误的发布路径和有问题的 fallback 行为。

明确说明你的部署目标

要清楚说明你想要的是预览、生产发布，还是帮你关联一个已有站点。比如“Deploy to preview and tell me the URL”和“make this production-ready”会走向不同的工作流。如果你希望 netlify-deploy usage 更高效，就不要让技能去猜你的风险承受度。

注意常见失败模式

最常见的问题是认证缺失、发布目录错误，以及 Netlify 自动识别的框架与实际构建输出不一致。如果部署失败，下一次最好的输入不是“再试一次”，而是完整的命令输出，再加上相关的 netlify.toml 片段。这样下一轮成功的概率会高得多。

用具体约束持续迭代

如果第一次结果已经接近但还不对，就用更明确的约束收紧请求，比如“不要改 build command”、“保持现有站点关联”或“只使用 preview deploy”。netlify-deploy guide 最好用的方式，是根据失败点来细化：认证、关联、配置，还是发布路径。