SuperAPI AI 工具集

workers-best-practices

部署与运维

查看项目

更新于 10-16 06:22

技能介绍

用途:按生产最佳实践评审和编写 Cloudflare Workers 代码,适用于新建 Worker、评审现有代码以及配置项目。

主要能力:覆盖配置(compatibility_date、nodejs_compat、用 wrangler types 生成 Env、wrangler secret put 管理密钥、使用 JSONC 配置)、请求与响应处理(流式处理大或未知负载、用 ctx.waitUntil 做响应后工作且不要解构 ctx)、架构(优先使用 KV、R2、D1、Queues 等进程内绑定而非 REST API,异步工作迁出关键路径,Worker 间调用用 service bindings,外部 PostgreSQL/MySQL 用 Hyperdrive)、可观测性(配置中启用 observability 与 head_sampling_rate,结构化 JSON 日志)、代码模式(避免模块级请求状态、所有 Promise 必须 await/return/void 或交给 ctx.waitUntil)、安全(用 crypto.randomUUID()/crypto.getRandomValues(),不用 Math.random(),避免 passThroughOnException)。

使用方式:编写或评审前先检索最新资料,包括 Workers 最佳实践页面、workers types 与 wrangler config-schema.json。可用命令获取最新类型:mkdir -p /tmp/workers-types-latest && npm pack @cloudflare/workers-types --pack-destination /tmp/workers-types-latest && tar -xzf /tmp/workers-types-latest/cloudflare-workers-types-*.tgz -C /tmp/workers-types-latest。随后阅读完整文件而非仅 diff,检查类型、配置、模式与安全,并用 npx tsc --noEmit 及 no-floating-promises lint 校验。

限制:本技能仅覆盖 Workers 特有最佳实践与代码评审;Durable Objects、Workflows、Wrangler CLI 命令等主题需加载对应技能。要求先检索再下结论,并对每个问题提供行号、工具输出或文档链接作为依据。资料未提供价格、平台支持范围或具体性能数据。