Cloudflare Wrangler 部署助手
帮助代理可靠地使用 Wrangler 构建、开发、部署和管理 Cloudflare Workers。
技能明确要求优先使用官方文档和配置 schema，并对密钥、远程绑定、日志和删除操作给出部分安全提示；但部署、删除、远程数据库及付费 AI 操作缺少明确的逐项用户确认、权限最小化、数据流披露和恢复前置检查，因此扣分。
内容覆盖面广、命令与故障排查相互对应，且说明了本地与远程模式；但未提供针对关键命令的测试套件或静态可复现证据，若命令或配置已变化也缺少版本锁定和可诊断失败流程，因此按静态上限保守扣分。
目标用户和主要场景较清楚，涵盖开发、配置、部署和资源管理，并强调检索最新资料；但未明确不适用范围、触发边界、输入输出约定或中文使用支持，核心检索依赖 Cloudflare 海外文档可达性，环境适配证据有限，因此扣分。
文档按主题组织，包含快速开始、命令表、配置示例、测试和故障排查；但缺少 skill 专属版本、变更记录、维护责任人、明确更新路径、依赖版本策略和较完整的限制/FAQ，因此扣分。Apache-2.0 许可证存在，但发布者身份未被验证。
对常见 Wrangler 工作流提供了可直接复制的命令和配置片段，能覆盖核心任务；但命令正确性未被本次静态审查以执行证据验证，部分示例涉及占位符、账户状态和外部资源，且结果格式与成功判据不够明确，因此未接近静态上限。
提供官方文档、配置 schema 和 Cloudflare 文档作为追溯入口，仓库还有 Semgrep CI；但没有覆盖 Wrangler 关键路径的提交测试、执行日志或多来源交叉验证，Semgrep 工作流也不能证明命令可运行，因此仅给有限分数。
- 不要在未确认目标账户、环境、资源和计费影响前运行 deploy、delete、rollback、remote 数据库操作或远程 AI 操作。
- 远程绑定和 Workers AI 可能访问真实数据并产生费用；应先核对配置、权限、账户和数据范围。
- 命令、配置字段和 2026-01-01 示例兼容日期可能过时；执行前应验证当前官方文档和本地 schema。
- 未提供关键命令的静态测试或执行记录，不能将示例视为已验证流程。
- 大陆网络访问 Cloudflare 文档和服务的可用性未在材料中证明。
这个 Skill 能做什么，适合哪些场景？
这是一个面向 Wrangler CLI 的 Agent Skill，服务于 Cloudflare Workers 项目的开发与运维。它要求代理优先检索最新的 Cloudflare 文档和配置架构，而不是依赖过时知识。内容覆盖 Worker 初始化、本地开发、部署、配置、类型生成、日志、测试，以及 KV、R2、D1、Vectorize、Hyperdrive、Workers AI、Queues、Containers、Workflows、Pipelines 和 Secrets Store 等资源。它适合需要通过命令行管理 Cloudflare 项目的开发者，但实际命令执行、账户认证和资源权限仍取决于本地环境。
指导代理先检查 wrangler --version，必要时安装 wrangler@latest；根据 wrangler.jsonc 和配置架构设置 Worker、环境、兼容性日期及资源绑定；运行 wrangler dev、wrangler deploy、wrangler types、wrangler tail、wrangler check startup 等命令；提供 KV、R2、D1、Vectorize、Hyperdrive、Workers AI、Queues、Containers、Workflows、Pipelines、Secrets Store 和 Pages 的管理命令；说明本地秘密、远程绑定、部署回滚、Vitest 测试和常见故障排查方式。
- Cloudflare Workers 开发者需要从零初始化 Worker，并配置 `wrangler.jsonc`。
- 团队需要在本地使用模拟绑定或远程资源测试 Worker。
- 工程师需要部署 Worker、生成 TypeScript 绑定类型、查看日志或分析启动时间。
- 开发者需要通过 Wrangler 创建和管理 KV、R2、D1、Vectorize、Queues 或其他列出的 Cloudflare 资源。
- 团队需要为 staging 和 production 配置环境，并以更安全的方式管理秘密。
这个 Skill 有哪些优点和局限？
- 覆盖 Wrangler 的开发、部署、配置、调试和资源管理流程。
- 明确强调检索最新文档，降低 CLI 参数和配置字段过时的风险。
- 包含本地绑定、环境配置、类型生成、秘密管理和回滚等实际工作流。
- 对秘密值处理给出明确的安全限制。
- 内容依赖 Cloudflare 文档、配置架构和本地 Wrangler 版本，不能保证示例始终与最新版本一致。
- 需要 shell、文件系统、网络访问以及 Node.js 和 Wrangler 环境。
- 来源未提供独立测试套件或平台兼容性验证结果。
- Workers AI 即使在本地开发中也会连接远程服务并产生使用费用。
如何安装这个 Skill？
该仓库是包含多个技能的集合。可运行 npx skills add https://github.com/cloudflare/skills 安装集合；若只使用本技能，将仓库中的 skills/wrangler 文件夹复制到所用 Agent 的技能目录。README 列出的目录包括 Claude Code 的 ~/.claude/skills/、Cursor 的 ~/.cursor/skills/、OpenCode 的 ~/.config/opencode/skills/、OpenAI Codex 的 ~/.codex/skills/ 和 Pi 的 ~/.pi/agent/skills/。来源未说明单独安装 wrangler 技能的专用命令。
如何使用这个 Skill？
在需要使用 Wrangler 命令或配置 Cloudflare Workers 时触发，例如：“使用 Wrangler 初始化一个 Worker，配置 D1 和 R2，并给出本地开发与部署步骤。”代理应先检索 https://developers.cloudflare.com/workers/wrangler/ 等来源，再检查 Wrangler 是否已安装。若未安装，可运行 npm install -D wrangler@latest；随后根据需要运行 wrangler dev、wrangler deploy、wrangler types 或其他参考命令。