Workers 生产实践审查
按最新 Cloudflare 资料审查并编写可上线的 Workers 代码。
该技能主要提供代码审查建议，强调密钥不入源代码、绑定优先、显式错误处理和最小化跨服务调用，未见恶意行为或明显过度权限，因此基础信任较高。扣分在于要求联网获取 Cloudflare 文档和执行 npm pack、npx 等外部操作，但未说明用户确认、网络数据流、依赖完整性、失败回滚或敏感内容处理。
SKILL.md、review.md 和 rules.md 的检索、类型、配置、模式及安全检查流程总体一致，且给出失败风险和诊断方向。扣分在于依赖 npm、node_modules、wrangler、搜索工具和网络可用性，命令缺少错误处理、版本锁定和不可用时的明确替代路径；静态审查也无法复现关键流程，因此不超过10分。
触发场景、覆盖范围以及 Durable Objects、Workflows 和 Wrangler 的非适用边界写得较清楚，并区分模块处理器与平台基类。扣分在于缺少明确输入输出格式、误触发排除条件和环境要求；未提供中文使用支持，且核心检索依赖 Cloudflare 海外文档和 npm 服务，对中国大陆网络可达性未作说明。
文档分为主说明、审查流程和规则参考，具备渐进披露、示例、反模式和严重级别定义；仓库提供 Apache-2.0 许可证和安装说明。扣分在于技能本身没有版本号、变更日志、维护责任人、更新路径或依赖版本策略，且部分安装与治理信息只存在于共享 README。
该技能能为 Workers 编写和审查提供具体检查清单、代码模式、反模式及建议验证命令，核心任务具有直接指导价值。扣分在于没有提交的代表性审查输出或执行证据，检索结果、类型有效性和命令成功与否仍需用户自行验证；静态校准下不超过7分。
规则包含相对明确的 Cloudflare 文档路径、命令、检查项和示例，具备一定可审计性；仓库还有 Semgrep CI，但其配置未证明覆盖该技能关键路径，也没有针对技能内容的测试或独立第三方复现证据。因此仅给有限静态可验证性。
- 核心流程依赖实时 Cloudflare 文档、npm 包和本地工具；网络、服务或版本不可用时，技能未定义充分的降级与可诊断错误输出。
- 检索内容可能将外部文档或最新类型直接带入审查过程，未明确提示如何处理不可信、冲突或包含敏感数据的返回内容。
- 未提供中文示例或中国大陆网络可达性说明，中文用户可能需要自行转换术语和解决访问问题。
- 未见技能级测试、版本记录、变更日志或明确维护责任人。
这个 Skill 能做什么，适合哪些场景？
该技能用于编写和审查 Cloudflare Workers 代码，以及检查 wrangler.jsonc 配置。它重点覆盖流式响应、Promise、全局状态、密钥、绑定、可观测性和安全处理等常见问题。执行任务前，它要求检索最新的 Cloudflare 文档、Workers 类型和 Wrangler 配置架构。它适合希望将 Workers 代码按生产实践进行验证的开发者，但不是 Durable Objects、Workflows 或 Wrangler CLI 的专门技能。
读取 Cloudflare Workers 最佳实践页面、Workers 类型定义、项目中的 Wrangler 配置架构以及相关参考文件；检查完整源文件、绑定访问、处理器类型、配置字段、流式处理、浮动 Promise、全局状态、序列化边界、密钥和加密用法；建议运行 npx tsc --noEmit、Wrangler 类型生成和 lint 检查；根据规则提供问题、证据和可复制的修正模式。
- 开发者新建 Worker 项目，需要检查兼容性日期、nodejs_compat、绑定和密钥配置。
- 团队审查 Worker PR，需要发现未等待的 Promise、无界响应读取或模块级请求状态。
- 维护者检查 KV、R2、D1、Queues、Service Bindings 或 Hyperdrive 的访问方式。
- 工程师准备生产部署，需要补充日志、追踪、结构化错误处理和安全随机数。
- 开发者面对不确定的 Workers API 或类型定义，需要先检索最新官方资料再修改代码。
这个 Skill 有哪些优点和局限？
- 明确要求优先检索最新文档，降低 Workers API 和配置过时的风险。
- 覆盖配置、请求处理、架构、可观测性、代码模式和安全性。
- 提供具体反模式及其影响，便于代码审查和修复。
- 强调证据、类型检查和开发者会复制到生产环境的代码。
- 依赖网络检索、Node.js/npm、Wrangler 和 TypeScript 等本地工具。
- 源材料没有提供测试套件、性能基准或实际审查结果。
- 范围集中于 Workers 最佳实践，Durable Objects、Workflows 和 Wrangler CLI 需要其他技能或资料。
- README 主要说明整个技能集合，未给出此单项技能的独立安装命令。
如何安装这个 Skill？
安装整个仓库后，将 skills/workers-best-practices 文件夹复制到所用 Agent 的技能目录。README 明确列出了 Claude Code 的 ~/.claude/skills/、OpenAI Codex 的 ~/.codex/skills/ 等目录；也可以使用 npx skills add https://github.com/cloudflare/skills，或按对应客户端的 GitHub 技能安装方式操作。仓库未提供仅安装这一项技能的专用命令。
如何使用这个 Skill？
在支持 Agent Skills 标准的客户端中提出涉及 Cloudflare Workers 的编写或审查请求，例如：“审查这个 Worker，重点检查流式响应、浮动 Promise、绑定访问、密钥处理和 wrangler.jsonc 配置。”技能会先要求检索最新参考资料，再按完整文件、类型、配置、代码模式和安全性进行检查。