1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | wrangler-cloudflare-skills |
| 项目自述名称 | Cloudflare Skills（仓库 README 标题；子技能自身 name 字段为 “wrangler”） |
| 作者/维护者 | Cloudflare，GitHub 官方组织 cloudflare |
| 来源链接 | https://github.com/cloudflare/skills/tree/main/skills/wrangler |
| 许可证 | Apache-2.0（GitHub API 取数，仓库级） |
| GitHub Stars | 2,190（GitHub API 取数，2026-07-17；注：该数字属 cloudflare/skills 整个合集仓库，不代表本技能自身热度） |
| Forks | 212（GitHub API 取数，同上口径） |
| 最新版本 | 未获取——仓库未使用 GitHub Releases/Tag 发版，采用持续提交式发布；技能要求配套的 Wrangler CLI 本体为 v4.x 及以上 |
| 安装方式 | Claude Code 插件市场一条命令安装，或 npx skills / 手动复制 |
2. 功能介绍与亮点
wrangler 是 Cloudflare 官方合集仓库 cloudflare/skills 中的技能，教 Agent 正确使用 Wrangler——Cloudflare Workers 平台的官方命令行工具：
- 全平台覆盖：一份技能涵盖 Workers、KV、R2、D1、Vectorize、Hyperdrive、Workers AI、Containers、Queues、Workflows、Pipelines、Secrets Store 等十余项 Cloudflare 产品的部署与管理命令
- 检索优先设计：技能开篇即声明“Wrangler 的 CLI 参数、配置字段可能已超出训练知识范围，任务时应优先检索 Cloudflare 官方文档而非依赖预训练记忆”，并给出具体的文档检索地址与本地 config-schema.json 路径——直接针对编码 Agent 因 CLI 快速迭代而“记忆过期、命令幻觉”的常见失败模式
- 凭据安全规范内建：明确写明“绝不将密钥值作为命令行参数传递或用 echo 输出”，并给出交互式输入、文件管道、
wrangler secret bulk等安全存取方式 - 结构完整：922 行文档，含快速入门、核心命令速查表、完整配置示例（
wrangler.jsonc）、各产品线（KV/R2/D1/Queues/Secrets Store 等）分节命令与本地开发调试指引
亮点：官方一线基础设施厂商出品；Apache-2.0 完全开源可审计；子目录本身有多次针对性维护提交（含一次专门修复凭据处理方式的安全加固提交）；仓库整体持续维护，最近一次提交发生在 2026-07-13。
3. 适用场景
所属分类：DevOps 与基础设施
面向使用 Claude Code、Codex 等编码 Agent 在 Cloudflare Workers 平台上做部署与运维的初中级工程师：无论是初始化一个 Worker 项目、绑定 KV/R2/D1 等存储、配置 Secrets Store，还是排查本地开发环境的调试问题，该技能都能让 Agent 生成语法正确、遵循官方最佳实践的 Wrangler 命令，避免因 CLI 版本快速迭代导致的命令幻觉与配置错误。
4. 跨 Agent 兼容性
README 明确写明：cloudflare/skills 中的技能“works with any agent that supports the Agent Skills standard, including Claude Code, OpenCode, OpenAI Codex, and Pi.”
- Claude Code：原生支持——README 提供专门的插件市场安装命令
/plugin marketplace add cloudflare/skills，并列出~/.claude/skills/作为通用安装目录 - Codex：原生支持——README 明确列出 OpenAI Codex 及其技能目录
- OpenClaw：未验证——材料未提及；SKILL.md 采用通用 Agent Skills 标准格式（YAML frontmatter + Markdown），理论上可移植，但未见官方测试或适配声明
- Hermes Agent：未验证——同上，材料未提及
5. 推荐理由
Wrangler 是 Cloudflare Workers 生态事实上的唯一官方部署工具，但其命令与配置格式随产品线扩张（Vectorize、Hyperdrive、Workers AI、Secrets Store 等均是较新加入的能力）迭代频繁，通用编码 Agent 极易凭训练记忆生成过期或臆造的命令。这份官方技能以“检索优先于预训练”为设计原则，把十余项 Cloudflare 产品的最新命令与安全的凭据管理方式直接写进 Agent 操作规范，是目前覆盖面最广、也是同仓库中被维护者专门做过安全加固的旗舰技能，适合任何计划让 AI 编码 Agent 直接操作 Cloudflare 账号的初中级工程师安装。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 官方一线基础设施厂商（Cloudflare）出品；InfoQ、BrightCoding 等科技媒体报道过 cloudflare/skills 整体计划；子目录本身有 5 次针对性维护提交（含社区驱动的安全修复与事实性纠错），但未找到针对 wrangler 技能本身的 Reddit/HN 独立讨论帖 |
| 可用性 | 9 | 一条命令安装（Claude Code 插件市场 / npx skills）；922 行文档结构完整、示例丰富，覆盖十余项产品线；子目录最后一次实质性提交为 2026-04-22（距今约 3 个月），仓库整体 2026-07-13 仍有提交，维护活跃 |
| 安全性 | 9 | 见下表 |
| 综合评分 | 8.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ①Shell 命令执行范围 | 技能本身为文档/参考资料，不含可执行脚本；实际操作经由用户本机安装的 wrangler CLI 完成，范围限于用户自己的 Cloudflare 账号资源，需用户主动触发 |
| ②运行时联网外发 | 文档要求的网络通信均为 Wrangler 与 Cloudflare 官方 API 之间的部署/管理请求，透明且是工具本身功能所需，未见隐蔽外发目标 |
| ③API Key/凭据存储 | 文档专节强调“绝不将密钥作为命令行参数传递或用 echo 输出”“绝不在配置中硬编码密钥”，并给出交互式输入、文件管道、CI 环境变量等安全存取方式 |
| ④可疑指令/注入迹象 | 抓取的 SKILL.md 全文未发现要求执行未授权操作或访问技能范围外文件/凭据的指令 |
| ⑤作者/组织信誉 | cloudflare 官方 GitHub 组织，Cloudflare 为一线基础设施服务商 |
| ⑥License | Apache-2.0，明确 |
| ⑦最近维护 | 子技能路径最后提交 2026-04-22；仓库整体 2026-07-13 仍有提交，维护活跃；提交历史显示曾有一次凭据处理方式的问题（PR #42）已被及时修复，体现良好的安全治理流程 |
7. 跟同类 Skills 相比的优势
DevOps 与基础设施类中定位相近的官方云平台 CLI/部署技能对比：
| 名称 | 定位 | 与本技能的差异 |
|---|---|---|
| wrangler-cloudflare-skills（本推荐） | Cloudflare Workers 平台全产品线官方 CLI 操作指南（Workers/KV/R2/D1/Vectorize/Queues/Secrets Store 等） | 覆盖面是同类云平台部署技能中最广的一个，且专门内建“检索优先”设计应对 CLI 快速迭代问题 |
| cloudflare-cloudflare-skills（同仓库） | Cloudflare 全平台通用入口，涵盖 Workers/Pages/存储/AI/网络/安全/IaC 的综合导航 | 定位更宽泛的平台综合导航技能，wrangler 是其姊妹技能之一，专注命令行操作细节，二者互补而非竞争 |
| agents-sdk-cloudflare-skills（同仓库） | 在 Cloudflare Workers 上构建带状态 AI Agent 本身（RPC/调度/工作流） | 聚焦“用 Agent 构建 Agent 产品”这一细分场景，与 wrangler 的“部署与资源管理”是同一平台内的不同分工 |
| deploy-to-vercel-vercel-labs-agent-skills（Vercel 官方） | 使用 Vercel CLI 完成 Vercel 平台的部署 | 竞品云平台的对应部署工具，功能聚焦单一部署动作，不像 Wrangler 覆盖存储、AI、队列等多产品线绑定与管理 |
| netlify-deploy-netlify-context-and-tools（Netlify 官方） | Netlify 平台的部署与站点管理 | 同为竞品静态站点/边缘平台的官方部署技能，产品线覆盖面（存储、AI、消息队列等）明显窄于 Wrangler |
| gcloud-google-skills（Google 官方） | Google Cloud 全平台通用 CLI 操作 | 覆盖的云厂商生态规模更大，但正因如此单个 SKILL.md 广度与深度的取舍不同，聚焦命令语法而非像 Wrangler 那样针对单一边缘平台做深度产品线整合 |
8. 用户评价
该技能目前在第三方平台尚无可验证的具名用户评价。InfoQ、BrightCoding 等科技媒体对 cloudflare/skills 整体计划有过报道，但内容聚焦仓库整体定位与能力介绍，未针对 wrangler 这一具体子技能给出使用体验或评价。
9. 其他补充
cloudflare/skills是持续扩张的合集仓库，wrangler 与 cloudflare、agents-sdk、durable-objects、sandbox-sdk、web-perf、cloudflare-one 等同为其中的姊妹技能，本报告只覆盖 wrangler 这一项- 仓库当前开放 28 个 issue，反馈渠道活跃
- 官方文档站点（developers.cloudflare.com）已将 Agent Skills 作为独立文档板块维护，侧面印证 Cloudflare 对该技能体系的长期投入
10. 安装使用方式
# Claude Code（插件市场，推荐）
/plugin marketplace add cloudflare/skills
/plugin install cloudflare@cloudflare
# npx skills CLI
npx skills add https://github.com/cloudflare/skills
# 手动安装：clone 仓库后复制 skills/wrangler 目录到本地 Agent 技能目录
# Claude Code 对应目录：~/.claude/skills/安装后无需重启，Agent 在判断当前任务涉及 Cloudflare Workers 部署或管理时会自动加载生效。使用前需先在本机安装 Wrangler CLI 本体（npm install -D wrangler@latest，要求 v4.x 及以上）并完成一次 wrangler login 账号鉴权，技能本身不代为处理账号凭据。
11. 注意事项
- 该技能是
cloudflare/skills合集仓库中的一个子技能，其余姊妹技能（cloudflare 综合入口、agents-sdk、durable-objects 等）各自独立，覆盖更细分场景需额外安装 - OpenClaw、Hermes Agent 兼容性未见官方材料佐证，如需使用建议自行验证
- 实际部署到 Cloudflare 涉及 Workers/KV/R2/D1 等产品计费，虽多数产品线有免费额度，规模化使用后需自行评估成本
- 技能明确要求 Wrangler CLI 版本需在 v4.x 以上，使用过旧版本 CLI 可能与技能中的命令示例不完全匹配