云开发 Skills 怎么接？AI 插件、npx 安装、手动复制三种姿势

摘要： 把云开发 CloudBase 接进 AI 工具有三条路：装 AI 插件（一次装齐 MCP 加 Skills）、单独装 Skills 技能包、手动复制规则文件。推荐第一条，激活最稳定。 开通环境再接工具：云开发 CloudBase

很多人配完 MCP 就以为接好了，结果 AI 写出来的云开发代码还是不对——漏掉了 Skills 这一层。MCP 和 Skills 分工明确：MCP 提供连接与工具，Skills 提供规则与最佳实践。只有 MCP，AI 能调云资源但容易写错用法；两者都有，AI 才知道微信登录该怎么配、数据库权限该怎么设。下面给三种接入方式的完整命令和适用场景，以及接不上时的排查顺序。

一、先分清 MCP、Skills、AI 插件三者关系

这三个词经常被混着说，其实职责完全不同：

官方的建议很明确：单独安装 Skills 时，AI 是否自动选用取决于模型和工具，不一定稳定；想让它更稳定生效，直接装 AI 插件。

二、姿势一：安装 CloudBase AI 插件（推荐）

这是激活最稳定的方式，Codex、Claude Code、WorkBuddy 都已支持，全套配置一次搞定。

最省事的做法是让 AI 自己完成接入。把下面这段原样粘到你的 AI IDE 里：

帮我把 CloudBase 接好，按下面做：
1. 打开 https://docs.cloudbase.net/skill.md，按说明完成接入。
2. 接入完成后告诉我，并建议最相关的下一步。

AI 会读文档、按说明配置、完成后给你反馈。这条指令的好处是不依赖你记住具体命令，工具版本更新了也不会过时。

三、姿势二：用 npx 安装 Skills 技能包

适用于 Claude Code、Cursor、VS Code、GitHub Copilot、OpenCode 等支持 Skills 开放规范的工具。在项目根目录执行：

npx skills add tencentcloudbase/cloudbase-skills

按提示选择你的 AI 工具即可。

只想装某一个 Skill 时，可以指定：

npx skills add https://github.com/tencentcloudbase/skills --skill auth-tool

GitHub 连不上时用 CNB 镜像。短名 owner/repo 会走 GitHub，clone 失败就换完整 CNB 地址：

npx skills add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills.git -y

这条在国内网络环境下很实用，遇到 clone 超时直接换镜像，比反复重试快。

四、姿势三：手动复制规则文件

如果 npx skills add 跑不通（网络受限、工具不支持 Skills 规范），可以把规则文件复制到项目里，再在对话中引用。不同工具的引用方式不一样：

这种方式最可控，但更新规则要手动同步，适合作为前两种方式的兜底。

五、还有一条更简单的路：让 AI 下载云开发规则

如果你已经配好 MCP，不想折腾 Skills 安装，可以直接对 AI 说：

在当前项目中下载云开发 AI 规则

AI 会自动下载并补全规则配置到项目目录。嫌生成的配置文件太杂，可以指定只要你用的那套：

在当前项目中下载云开发 AI 规则，只包含 Cursor 配置

把 Cursor 换成 WindSurf、Claude Code、CodeBuddy 都可以。规则需要更新时，对 AI 说「下载云开发 AI 规则在当前项目中更新 rules」即可。

六、Skills 覆盖了哪些场景

官方 Skills 按场景划分，装好之后 AI 会按需调用，不用你手动指定。主要分六类：

身份认证：配置管理、Web SDK、微信小程序、Node.js 服务端四套认证方案。

数据库：文档数据库（Web SDK 与小程序 SDK）、关系型数据库（MySQL、PostgreSQL）、PostgreSQL 设计与性能最佳实践。

后端开发：云函数、云托管（Node.js / Python / Go / Java）、cloudbaserc 声明式部署、Cloud API 操作与 CAM 授权。

应用集成：Web 应用（React / Vue / Vite）、微信小程序、微信生态集成（微信支付、公众号 OAuth）、UI 设计、App 集成、云存储。

AI 能力：在 Web、Node.js 后端、微信小程序中集成 AI 功能，以及 AI Agent 服务构建与部署。

开发工具：Spec 工作流（需求分析、技术设计、任务拆分）、平台知识库、CLI、代码审查、环境巡检与诊断、问题反馈。

做微信支付就会命中「微信生态集成」，做登录就命中「身份认证」，不用你记住对应哪个 Skill。

七、装完之后怎么确认真的生效了

装完别急着写业务，先花两分钟验证。

第 1 步：确认 MCP 工具数量不为 0。 到 AI 工具的 MCP 列表里看 cloudbase 的工具数。显示 0 说明没装成功，跳到第八节排查。

第 2 步：让 AI 自述能力。 对 AI 说：

阅读 https://docs.cloudbase.net/skill.md，帮我介绍可以做什么

它应该能说出数据库、云函数、存储、托管这些具体能力，而不是泛泛地说「可以帮你开发」。

第 3 步：跑一个带规范的小任务。 让 AI 做一件能体现 Skills 价值的事：

用 CloudBase 做一个最小的待办应用，用 Web SDK 读写数据库，说明你为什么这样设置集合权限

重点看它会不会主动说明权限设置的理由。装了 Skills 的 AI 通常会提到权限模型，没装的往往只给代码。

八、接不上时按这个顺序排查

MCP 工具数量显示 0：这是最常见的问题，按三步查。一是确认 Node.js 版本为 v18.15.0 及以上；macOS 用 nvm 管理 Node 的，要把默认版本也设成 v18.15.0 以上，避免不同终端版本不一致。二是设置 npm 源为腾讯镜像：

npm config set registry https://mirrors.cloud.tencent.com/npm/

三是在 MCP 列表里禁用 cloudbase 再重新启用，仍不行就完全重启 AI IDE。

提示 MCP error -32001: Request timed out：多半是 npx 每次重新下载导致超时。改用全局安装：

npm install @cloudbase/cli@latest -g

装完会生成全局命令 cloudbase-mcp，MCP 配置改成：

{
  "mcpServers": {
    "cloudbase": {
      "command": "cloudbase-mcp"
    }
  }
}

重启 AI IDE 后通常就正常了。全局安装还有个好处：多个 AI IDE 之间切换不用重复配置。

MCP 配置不生效：检查配置格式是否正确（JSON 有没有多逗号）、重启 AI IDE、确认 MCP 服务已启用，三步基本能覆盖。

Safari 无法完成授权登录：换 Chrome。Safari 在某些情况下对授权流程兼容性不好。

登录成功但看不到环境：这不是接入问题，是站点或账号问题。国内站与国际站是两套独立账号体系，未显式指定站点时按国内站处理。远端模式下用国内站域名 tcb-api.cloud.tencent.com 即可；做小程序的记得登录时选「小程序 / 公众号」登录，而不是腾讯云主账号。

九、远程环境和 CI 场景怎么接

服务器没有图形界面，没法走浏览器授权，这时候用环境变量。推荐用 CloudBase API Key，它是环境级长期凭证，MCP 会自动换取临时密钥并在过期后刷新：

{
  "mcpServers": {
    "cloudbase": {
      "command": "cloudbase-mcp",
      "env": {
        "CLOUDBASE_API_KEY": "你的 CloudBase API Key",
        "CLOUDBASE_ENV_ID": "云开发环境 ID"
      }
    }
  }
}

API Key 在云开发控制台的环境设置里创建和管理。这套配置适合 GitHub Codespaces、云 IDE、服务端自动化脚本和 CI/CD 流水线。

有一条安全提示要特别注意：如果你把 MCP 部署在远程服务器并对外提供 HTTP 接口，务必设置 CLOUDBASE_MCP_CLOUD_MODE=true。这会禁用涉及本地文件读写和进程启动的工具，防止远程调用方操作服务器本地资源。只在本机用则不需要。

总结

接入云开发 CloudBase 的三种姿势里，装 AI 插件最稳（一次拿到 MCP 加 Skills 加 Hooks），npx skills add 最灵活（可单装、可换 CNB 镜像），手动复制规则最可控（适合网络受限）。记住 MCP 管连接、Skills 管规范，两者缺一不可。装完务必做三步验证——看工具数量、让 AI 自述能力、跑一个带规范的小任务。遇到工具数量为 0，先查 Node 版本和 npm 源，再考虑全局安装。

接好工具，开通环境开始开发：云开发 CloudBase 购买页