SuperAPI AI 工具集

workers-best-practices

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:在编写或审查 Cloudflare Workers 代码时,按生产最佳实践进行校验。资料强调对 Workers API、类型与配置的既有知识可能过时,因此任何 Workers 代码任务都应优先检索而非依赖预训练知识。

主要能力:覆盖配置(compatibility_date 设为今天、启用 nodejs_compat、用 wrangler types 生成 Env、用 wrangler secret put 管理密钥、使用 wrangler.jsonc)、请求与响应处理(流式处理大负载、用 ctx.waitUntil() 做响应后工作且不解构 ctx)、架构(优先用进程内绑定而非 REST API、用 Queues/Workflows 移出关键路径、Worker 间用 service bindings、外部数据库用 Hyperdrive)、可观测性(配置 head_sampling_rate、结构化 JSON 日志)、安全(用 crypto.randomUUID/getRandomValues、禁用 passThroughOnException)等规则。

使用方式:先获取最新参考资料,包括 Workers 最佳实践页、类型定义与 Wrangler 配置 schema;可执行 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,类型位于 /tmp/workers-types-latest/package/index.d.ts。随后按审查流程:检索、读完整文件、检查类型与配置、检查模式与安全,并用 npx tsc --noEmit 等工具校验,参考 references/rules.md 与 references/review.md。

限制:资料只针对 Workers 本身,Durable Objects、Workflows、Wrangler CLI 等需另载对应技能。具体价格、版本号与平台细节暂未提供。