• 产品简介
  • 快速开始
    • 导入 Git 仓库
    • 从模板开始
    • 直接上传
    • 从 AI 开始
  • 框架指南
    • 前端
      • Vite
      • React
      • Vue
      • 其他框架
    • 后端
    • 全栈
      • Next.js
      • Nuxt
      • Astro
      • React Router
      • SvelteKit
      • TanStack Start
      • Vike
    • 自定义 404 页面
  • 项目指南
    • 项目管理
    • edgeone.json
    • 缓存配置
    • 构建输出配置
    • 错误码
  • 构建指南
  • 部署指南
    • 概览
    • 触发部署
    • 管理部署
    • 部署按钮
    • 使用 Github Action
    • 使用 Gitlab CI/CD
    • 使用 CNB 插件
    • 使用 IDE 插件
    • 使用 CodeBuddy IDE
  • 域名管理
    • 概览
    • 自定义域名
    • 配置 HTTPS 证书
      • 概览
      • 申请免费证书
      • 使用 SSL 托管证书
    • 配置 DNS 的 CNAME 记录
  • 可观测性
    • 概览
    • 指标分析
    • 日志分析
  • Pages Functions
    • 概览
    • Edge Functions
    • Cloud Functions
      • 概览
      • Node.js
      • Python
      • Go
  • 中间件
  • KV 存储
  • 边缘 AI
  • API Token
  • EdgeOne CLI
  • Pages MCP
  • Pages Skills
  • 消息通知
  • 集成指南
    • AI
      • 对话型大模型集成
      • 图片大模型集成
    • 数据库
      • Supabase 集成
      • Pages KV 集成
    • 电商
      • Shopify 集成
      • WooCommerce 集成
    • 支付
      • Stripe 集成
      • Paddle 集成
    • CMS
      • WordPress 集成
      • Contentful 集成
      • Sanity 集成
      • Payload 集成
    • 身份验证
      • Supabase 集成
      • Clerk 集成
  • 最佳实践
    • AI 对话式部署:使用 Skill 一句话部署项目
    • 使用通用大模型快速搭建 AI 应用
    • 使用边缘 AI 模型快速搭建对话型 AI 站点
    • 使用 Shopify 搭建电商平台
    • 使用 Supabase 和 Stripe 搭建 SaaS 站点
    • 如何快速搭建公司品牌站点
    • 如何快速搭建博客站点
  • 迁移指南
    • 从 Vercel 迁移至 EdgeOne Pages
    • 从 Cloudflare Pages 迁移至 EdgeOne Pages
    • 从 Netlify 迁移至 EdgeOne Pages
  • 排障指南
  • 常见问题
  • 联系我们
  • 产品动态

AI 对话式部署:使用 Skill 一句话部署项目

本文介绍如何通过安装 EdgeOne Pages Deploy Skill,让你在任何 AI 编程工具中一句话完成项目部署,帮你省去繁琐的部署流程,真正实现「对话即部署」。


背景介绍

Skill 是 Anthropic 提出的一套开放规范,以结构化的 Markdown 文件为载体,用于为 AI 工具注入特定领域的专业知识和操作流程。当 AI 工具加载 Skill 后,就具备了按照预定义流程自主完成专业任务的能力。你可以将 Skill 理解为一份交给 AI 的「操作手册」——Skill 本身不执行任何操作,而是告诉 AI 工具该做什么、怎么做、遇到问题如何处理。

EdgeOne Pages Deploy Skill 就是这样一份专为部署场景编写的操作手册。它将完整的部署流程、环境判断逻辑和错误处理机制封装其中。任何支持 Skill 的 AI 工具(如 CodeBuddy、Claude Code、Cursor 等)加载它之后,都能像一位专业的运维工程师一样,自主判断环境、选择策略、执行部署。而且,部署到 EdgeOne Pages 的项目是持久化的——每次部署都会更新同一个站点 URL,你可以不断迭代,就像使用传统的 CI/CD 流程一样。项目还可以在 EdgeOne Pages 控制台中管理,绑定自定义域名、查看部署历史等。


安装 Skill

Skill 安装非常简单,以下介绍三种方式。

方式一:通过自然语言安装(推荐)

在任何支持 Skill 的 AI 工具中直接输入:“帮我安装这个 skill:https://github.com/edgeone-pages/edgeone-pages-skills”
AI 工具会自动拉取仓库、解析 Skill 文件并完成安装,整个过程无需手动操作。

方式二:通过命令行安装

在终端中执行:
npx skills add edgeone-pages/edgeone-pages-skills

方式三:手动安装

GitHub 仓库 下载 Skill 文件,将 skills/edgeone-pages-deploy/ 目录放置到 AI 工具对应的规则目录中。各工具的目录位置和详细配置方式,请参考下文的“在不同 AI 工具中使用”。


部署项目

安装 Skill 后,即可在 AI 对话中通过自然语言触发部署。下面分别演示两种典型场景。

场景一:在 CodeBuddy 中开发并部署项目

当你在 EdgeOne Pages 开发项目需要新增功能,想要尽快开发并部署至预览环境验证时。
第一步:在 AI 对话中发起部署请求
在 CodeBuddy 的 AI 对话框中输入:“帮我新增个暗黑模式,然后部署一个预览环境到 EdgeOne Pages”。

第二步:自动完成环境检查、登录和部署
CodeBuddy 加载 Skill 后,会自动按照以下流程执行:
1. 环境检查:检测 EdgeOne CLI 是否已安装且版本正确,未安装则自动执行 npm install -g edgeone
2. 登录认证:检测登录状态,未登录则通过浏览器引导你完成认证
3. 项目构建:自动识别项目框架(如 Vue.js),执行构建命令
4. 部署上传:将构建产物部署到 EdgeOne Pages
整个过程中,你只需在 AI 提示时确认少量信息(如选择中国站/国际站),其余全部自动完成。
第三步:获取部署结果
部署成功后,AI 会返回:
访问 URL:可直接在浏览器中打开
控制台 URL:用于在 EdgeOne Pages 控制台管理项目

从发起部署到获取线上 URL,通常只需 1-2 分钟。之后每次修改代码,只需再说一句"部署到 EdgeOne Pages",就能将更新推到线上。


场景二:在 OpenClaw 中从零创建并部署项目

OpenClaw 是一个开源的 AI Agent 框架,支持接入企业微信、飞书、Telegram 等通讯工具,让你在手机 IM 中直接与 AI 对话完成开发和部署。
假设你在地铁上突然来了灵感,想做一个小游戏发给朋友玩。你不需要打开电脑,直接在 IM 中说一句话就够了:帮我做一个贪吃蛇小游戏,部署到 EdgeOne Pages”。
AI 会从零生成游戏代码,然后自动触发部署流程:检查环境 → 登录认证 → 构建项目 → 部署上线,最终返回一个可访问的线上 URL。把链接发给朋友,打开就能玩。即使游戏遇到 bug,你也可以在 OpenClaw 里面直接让它帮你修复并重新部署,即可看到修复后的版本。

在远程服务器、SSH 或 CI/CD 环境下,无法通过浏览器完成登录,Skill 会自动切换为 API Token 方式认证。Token 可通过以下地址创建:
Agent 还会在首次使用 Token 后询问是否将 Token 保存到本地(.edgeone/.token),后续部署可自动复用,无需重复输入。
注意:
API Token 具有 Pages 账户级别权限,请妥善保管,切勿提交到代码仓库。


在不同 AI 工具中使用

Pages Deploy Skill 基于通用的 Markdown 规范编写,兼容所有支持 Anthropic Skills 规范的 AI 编程工具。

Claude Code

Claude Code 原生支持 Skill 规范。通过命令行或自然语言安装后,Skill 会被自动放置到 ~/.claude/skills/(全局)或 .claude/skills/(项目级)目录中。你也可以手动将 Skill 目录复制到这些位置。

CodeBuddy

CodeBuddy IDE 原生支持 Skill 安装。通过命令行或自然语言安装后,Skill 会被自动放置到 .codebuddy/skills/ 目录中。你也可以通过 设置 → Skills 手动管理 Skill。更多信息可参考 使用 CodeBuddy IDE

Cursor

Cursor 原生支持 Skill 安装。通过命令行或自然语言安装后,Skill 会被自动放置到 ~/.cursor/skills/ 目录中。你也可以手动将 Skill 目录复制到该位置。


常见问题

Q: 部署失败怎么办?
A: Deploy Skill 中内置了完善的错误处理逻辑,AI 工具加载后会根据错误类型自动尝试修复。常见的自动修复场景包括:CLI 版本不匹配(自动重装正确版本)、登录过期(引导重新登录)、构建失败(分析构建日志并给出修复建议)。如果问题仍无法解决,可以将错误信息反馈给 AI,让它进一步分析。

Q: 支持哪些项目框架?
A: 支持所有 EdgeOne Pages 兼容的框架,包括 Next.js、Nuxt、Astro、Vite、React、Vue、SvelteKit 等。EdgeOne CLI 会自动识别框架类型并选择正确的构建策略,无需手动配置。

ai-agent
你可以这样问我
如何开始使用 EdgeOne Pages?