SrP-Skillsskill gazette & source index

community skill

Wrangler CLI

Cloudflare 官方 Wrangler CLI skill，指导 agent 使用 wrangler 命令部署、开发和管理 Workers、KV、R2、D1、Vectorize、Hyperdrive、Workers AI、Containers、Queues、Workflows、Pipelines 和 Secrets Store。优先从 Cloudflare 文档检索最新信息而非依赖预训练知识。

communityskill packagecloudflareworkerswranglerclideploymentserverless

Wrangler CLI

Wrangler CLI 是 Cloudflare 官方的 Workers 命令行工具 skill。它指导 coding agent 始终使用 wrangler（而非手动构造 API 请求）来部署、开发和管理 Cloudflare Workers 及其绑定的各种服务，包括 KV、R2、D1、Vectorize、Hyperdrive、Workers AI、Containers、Queues、Workflows、Pipelines 和 Secrets Store。

来源

适合什么时候用

  • 需要让 agent 部署或管理 Cloudflare Workers 项目，包括创建、配置、部署和删除 Worker。
  • 需要管理 Cloudflare 的存储和数据库服务：KV 命名空间、R2 存储桶、D1 数据库、Vectorize 向量索引等。
  • 需要进行本地开发调试，使用 wrangler dev 启动本地开发服务器并测试绑定。
  • 需要管理密钥、版本回滚、D1 数据库迁移、队列消费者绑定等运维操作。
  • 需要生成 TypeScript 类型定义，确保 Workers 绑定的类型安全。

核心能力

场景代表命令用途
项目管理wrangler init、wrangler deploy、wrangler delete创建、部署和删除 Worker
本地开发wrangler dev、wrangler dev --test-scheduled本地开发服务器、测试定时任务
类型生成wrangler types、wrangler types --check自动生成/检查 TypeScript 类型定义
KV 存储wrangler kv namespace create、wrangler kv key put管理 KV 命名空间和键值对
R2 存储wrangler r2 bucket create、wrangler r2 object put管理 R2 存储桶和对象
D1 数据库wrangler d1 create、wrangler d1 migrations apply管理 D1 数据库和迁移
密钥管理wrangler secret put、wrangler secret bulk安全管理 Worker 密钥
日志观测wrangler tail、wrangler tail --status error实时日志流和过滤

安装提示

这是 Cloudflare 上游的 skill 目录，包含 SKILL.md。本站只收录索引和中文说明，不镜像上游 skill 文件。站点详情页生成的安装命令会指向上游 skill 目录：

npx skills add https://github.com/cloudflare/skills/tree/main/skills/wrangler

实际使用前需要安装 Wrangler：

npm install -D wrangler@latest

首次使用需要登录认证：

npx wrangler login

使用注意

  1. Wrangler 要求 v4.x 及以上版本，可运行 wrangler --version 检查。
  2. 推荐使用 wrangler.jsonc（JSON 格式配置）而非 TOML，因为较新功能仅支持 JSON 格式。
  3. 始终设置 compatibility_date，建议使用 30 天内的日期以确保获得最新运行时特性。
  4. 配置变更后务必运行 wrangler types 更新 TypeScript 类型绑定。
  5. 本地开发默认使用本地存储模拟，如需连接真实资源可在绑定中设置 remote: true。
  6. 密钥管理应使用交互式提示（wrangler secret put）或文件输入（wrangler secret bulk），切勿在命令行中传递密钥明文。