用途:审查 Workers 及 Cloudflare Developer Platform 代码,关注类型正确性、API 用法和配置有效性,主要用于 TypeScript/JavaScript 代码评审。
主要能力:先构建上下文,阅读完整文件而非片段,判断代码是示意性、演示性还是可执行代码;再用工具验证,如 npx tsc --noEmit、npx eslint <files>,并对 wrangler 配置按最新 schema 校验;随后按规则检查绑定访问、禁止 any、禁止类型系统取巧、配置与代码一致性、必填配置字段、浮动 Promise、序列化、流式处理与错误处理;最后按 HIGH/MEDIUM/LOW 评估风险。
用法要点:优先查仓库本地副本,不要运行 npm pack 或安装包获取类型。wrangler 配置 schema 见 node_modules/wrangler/config-schema.json;Workers 类型见 node_modules/@cloudflare/workers-types/index.d.ts;Cloudflare 文档用 cloudflare-docs 搜索工具或读取本仓库文件。可用 git log --oneline -5 -- <file> 查看历史。需留意反模式:Env 或处理函数参数用 any、as unknown as T 双重断言、无说明的 @ts-ignore、缓冲无界数据、硬编码密钥、每请求 blockConcurrencyWhile、单一全局 Durable Object、DO 仅内存状态、缺少 DO 迁移、浮动 Promise、跨边界非可序列化值、平台基类用 implements 而非 extends。
输出格式:按严重级别列出问题,包含 file.ts:42 说明与证据及建议修复,结尾给出各类别问题数量汇总。限制:资料未提供具体收费、平台或效果信息;不得为凑长度编造功能。