Cloudflare Skills（Cloudflare 官方技能包）

# Cloudflare Skills：安装说明

这个工具包里是 Mindket 写的安装说明，不包含技能本身、它们的参考页面或插件文件。这些要从 Cloudflare 的仓库安装：https://github.com/cloudflare/skills

许可证：Apache-2.0。全文见 https://github.com/cloudflare/skills/blob/main/LICENSE

Cloudflare Skills 由 Cloudflare 制作。Mindket 只是收录它，并不是 Cloudflare。

这些说明的来源：README（https://github.com/cloudflare/skills/blob/main/README.md），https://github.com/cloudflare/skills/tree/main/skills 下每个技能的 SKILL.md，https://github.com/cloudflare/skills/tree/main/.claude-plugin 里的插件文件，MCP 文件 https://github.com/cloudflare/skills/blob/main/.mcp.json，以及 CONTRIBUTING.md。Claude Code 从哪里加载技能和插件，出自 Claude Code 自己的文档，用到的地方都注明了。所有命令都由 Mindket 照抄，一条也没有运行过。

## 它是什么

22 个技能，给在 Cloudflare 上开发的编程智能体用。技能就是一个带 SKILL.md 指令文件的文件夹，你的请求和它对得上时，智能体就会读取它。README 写道：“Skills are contextual and auto-loaded based on your conversation.”（技能按上下文、根据你的对话自动加载。）

这些技能大多不包含 Cloudflare 的文档。它们的 SKILL.md 文件，比如 cf-cli、agents-sdk 和 durable-objects，都说要优先检索、而不是依赖预训练知识：智能体去取 developers.cloudflare.com 上的当前页面，不凭记忆回答。CONTRIBUTING.md 也是同样的目标：帮智能体找到正确的文档，而不是再维护一份副本。

## 这 22 个技能

| 技能 | 适用于（README 的原话） |
|---|---|
| cloudflare | 帮智能体找到适合需求的 Cloudflare 产品，再找到对应的技能和文档 |
| basin | 用 Basin Pipelines、Basin Catalog 和 Basin SQL 搭建分析流程，包含 Data Platform 更名的内容 |
| k2 | 用 HTTP 或 Worker 生产者和订阅消费者构建持久的 K2 Streams |
| frameworks-on-cloudflare | 在 Workers 上运行 Astro、SvelteKit、React Router、TanStack Start、Nuxt、Hono 和 SPA |
| nextjs-on-cloudflare | 用 vinext 在 Workers 上运行 Next.js |
| agents-sdk | 构建有状态的 AI 智能体，带状态、定时、RPC、MCP 服务器、电子邮件和流式聊天 |
| durable-objects | 有状态的协调（聊天室、游戏、预订）、RPC、SQLite、闹钟（alarm）、WebSockets |
| sandbox-next | 基于 @cloudflare/sandbox@next（1.0 预览版）的 Sandbox，推荐新项目使用 |
| sandbox-stable | 基于当前稳定版 @cloudflare/sandbox 包的 Sandbox |
| sandbox-migrate-to-next | 把稳定版 Sandbox 应用移植到 @cloudflare/sandbox@next |
| cf-cli | 查找和运行 Cloudflare CLI（cf）命令，以及在 cf 和 Wrangler 之间做选择 |
| wrangler | 部署和管理 Workers、KV、R2、D1、Vectorize、Queues、Workflows |
| cloudflare-app-bootstrap | 让一个新的或刚检出的应用在本地响应请求：绑定、密钥、初始数据和验证 |
| workers-best-practices | 编写、审查或配置生产环境的 Workers |
| workers-development | 用 Local Explorer 做本地开发和调试：绑定数据、trace 和日志 |
| workers-profiling | 分析已部署的 Workers 和 Durable Objects 的 CPU 使用和内存分配热点 |
| cloudflare-email-service | 实现或排查 Email Sending、Email Routing 和投递配置 |
| turnstile-spin | 设置、修复或迁移 Turnstile 人机验证，包括服务器端的 Siteverify |
| web-perf | 审计 Core Web Vitals（FCP、LCP、TBT、CLS）、阻塞渲染的资源和网络请求链 |
| cloudflare-one | 设计、配置、排查或审查 Cloudflare One 部署（Access、Gateway、WARP、Tunnel 等） |
| cloudflare-one-migrations | 把 Zscaler、Palo Alto、传统 VPN/SWG 和 SASE 迁到 Cloudflare One 时的迁移评估、策略对应、上线计划和差距分析 |
| gateway-workers | 编写和审查由 Gateway HTTP 策略中 Forward 动作调用的 Workers |

来源：README 里的“Skills”表格和每个 SKILL.md。

## 工具包里的文件

- setup/claude-code.md：插件路线（两条命令）和克隆再复制路线
- setup/codex.md：Codex 插件路线和 Codex 的技能文件夹
- setup/vscode-copilot.md：在 VS Code 里从源码安装
- setup/cursor.md：Cursor Marketplace、远程规则或技能文件夹
- setup/other-agents.md：npx skills 命令，以及 OpenCode 和 Pi 的技能文件夹
- setup/first-run.md：技能指向的 cf 命令行工具、Wrangler、登录和 MCP 服务器

## 先准备好这些

- 一个 README 点名的编程智能体：Claude Code、Codex、VS Code 配合 GitHub Copilot、Cursor、OpenCode 或 Pi。
- 一个 Cloudflare 账号，凡是会改动你自己账号的事都要用，比如部署、建数据库或建 Turnstile 小组件。技能本身安装不花钱，README 也没有提到要为它们注册。
- 联网。技能会让智能体去读 Cloudflare 的文档页面。
- Node.js 22.18 或更高版本，如果智能体要用 cf 命令行工具（见 cf-cli 的 SKILL.md）。Wrangler 和 npx 路线也要用 Node.js。
- 只有 turnstile-spin 需要：运行它的 shell 脚本要用 Bash、curl 和 jq，还要一个由你创建的 Cloudflare API 令牌（setup/first-run.md）。
- Git，只有克隆路线才需要。

## 装到哪里

- 插件路线（Claude Code、Codex、VS Code）：插件的文件由智能体自己保管。插件里有这些技能，以及 Cloudflare 主要的远程 MCP 服务器，名叫 cloudflare，它在 .mcp.json 里的地址是 https://mcp.cloudflare.com/mcp。README 说它提供“the Cloudflare API and current developer documentation through the Code Mode MCP server”（通过 Code Mode MCP 服务器访问 Cloudflare API 和当前的开发者文档）。
- npx skills 和克隆再复制：只有技能文件夹，放在智能体自己的技能文件夹里，不带 MCP 服务器。
- 每个技能的文件夹要保持完整。SKILL.md 文件会指向它自己 references 文件夹里的页面。cloudflare 技能还会指向它的同伴技能，并说如果某个技能缺失，就改用产品文档。

## 你的数据

技能只是文本，自己不会发送任何东西。有三点要知道：

- turnstile-spin 是唯一一个在 SKILL.md 里运行自带脚本的技能。它说这些辅助脚本用 curl 访问 api.cloudflare.com，使用你创建的 API 令牌。这个技能要求绝不把令牌贴进聊天，并在每一步无法撤销的操作前先和你确认。
- 当你告诉智能体某个技能给的建议有错或过时，cloudflare 技能的反馈页面会让它在 cloudflare/skills 上起草一个公开的 GitHub issue。只有在你看过确切的标题和正文、并回答同意后，它才会发出。
- 你交给智能体的一切，比如代码和日志，都会像其他会话一样发给智能体自己的服务。MCP 服务器是 Cloudflare 自己的。插件的隐私政策链接是 https://www.cloudflare.com/privacypolicy/。

## 更新和卸载

README 没有给出更新或卸载的步骤。setup/claude-code.md 写了 Claude Code 自己的文档对插件和复制进来的技能文件夹给出的做法。

README.md  7 KB
setup/claude-code.md  4 KB
setup/codex.md  2 KB
setup/cursor.md  1 KB
setup/first-run.md  5 KB
setup/other-agents.md  2 KB
setup/vscode-copilot.md  891 B