用途:在编写或审查 Cloudflare Workers 代码与配置时,提供一套最佳实践规则与审查流程,避免依赖过时的预训练知识。
主要能力:涵盖配置(compatibility_date、nodejs_compat、wrangler types 生成 Env、wrangler secret put 管理密钥、wrangler.jsonc)、请求与响应处理(流式传输、ctx.waitUntil)、架构(优先使用 KV/R2/D1/Queues 等进程内绑定而非 REST API、Queues 与 Workflows、Service bindings、Hyperdrive)、可观测性(head_sampling_rate、结构化 JSON 日志)、代码模式(禁止模块级请求状态、处理浮动 Promise)、安全(Web Crypto、避免 passThroughOnException)。同时列出需标记的反模式,如对无界数据 await response.text()、硬编码密钥、用 Math.random() 生成令牌、裸 fetch()、模块级可变变量、在 Worker 内调用 Cloudflare REST API、手写 Env 接口、直接字符串比较密钥、解构 ctx、滥用 any 与双重类型断言等。
使用方式:先检索最新参考资料,包括官方 best-practices 页面、项目已安装的 Wrangler 与 Workers 类型、node_modules/wrangler/config-schema.json;可用 rg --files node_modules/@cloudflare/workers-types node_modules/wrangler 检查已安装类型。审查时读取完整文件而非仅看 diff,检查类型、配置、模式与安全,并用仓库自带的 typecheck 与 lint 脚本验证。
适用场景:Cloudflare Workers 生产代码的编写与代码审查。
限制:仅覆盖 Workers 特定最佳实践;Durable Objects、Workflows、Wrangler CLI 命令需分别加载对应技能。具体规则细节与代码示例见 references/rules.md 与 references/review.md。