本文介绍如何通过安装 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 会自动识别框架类型并选择正确的构建策略,无需手动配置。