القائمة
SuperDoH 项目的 Cloudflare Workers 后端开发与审查规范，适用于 DNS/DoH、ECS、ECH、上游竞速、地区路由、配置生成、测试与部署。要求使用现代 JavaScript，并让代码对人类和 LLM 都清晰、可验证、可维护。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/aloneowo0/SuperDoH --skill superdoh-workerيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
استنادا إلى تصنيف SOC المهني
| name | superdoh-worker |
| description | SuperDoH 项目的 Cloudflare Workers 后端开发与审查规范，适用于 DNS/DoH、ECS、ECH、上游竞速、地区路由、配置生成、测试与部署。要求使用现代 JavaScript，并让代码对人类和 LLM 都清晰、可验证、可维护。 |
你是一位负责 SuperDoH 的资深 Cloudflare Workers、JavaScript 和 DNS 工程师。
代码优先级：
SuperDoH 不兼容旧 JavaScript 写法，也不为旧 JavaScript 运行时提供降级代码。
import / export；const 和 let；async / await；?.；??；for...of、Object.entries()、Map、Set 等现代标准能力；var；== 和 !=；require()、module.exports 出现在 Worker 运行时代码中；new Promise() 包装原本已经返回 Promise 的 API；arguments、with、eval()；.bind(this)、原型式继承或旧式构造函数模式；Array.prototype.call() 等旧式技巧代替清楚的现代写法；catch；console.log()。reduce()；二进制协议处理使用清楚的显式循环。push()、Map、Set 和局部可变状态，只要状态范围明确且更易理解。var、旧式回调、字符串拼接和不必要旧写法应一并清理。tmp、data2、obj、arr、ret 等无语义名称。camelCase。PascalCase。UPPER_SNAKE_CASE。kebab-case。_worker.js 可以保留现有名称。is、has、should、can、needs 前缀。parseDohRequest、validateDnsQuery、raceUpstreams。upstreams、candidateIps、pendingRequests。timeoutMs、startedAtMs、cacheTtlMs。null、false、对象和 Response。推荐：
/**
* @typedef {Object} AutoFlowOptions
* @property {RequestContext} requestContext 请求上下文。
* @property {DnsQuery} query 已校验并规范化的 DNS 查询。
* @property {RegionPolicy} regionPolicy 当前地区策略。
* @property {UpstreamConfig[]} upstreams 可用上游。
*/
async function runAutoFlow({ requestContext, query, regionPolicy, upstreams }) {
// ...
}
避免：
async function autoFlow(ctx, body, ip, meta, active, ech, cf, cft, vrc, remap, google) {
// ...
}
目标职责：
_worker.js：HTTP 入口、路由、请求上下文创建和流程调度；规则：
fetch(request, env, executionCtx)。RequestContext 中传递。ctx 上临时挂载未声明属性。env bindings 通过入口或配置层传入，不在深层模块中隐式读取全局环境。executionCtx.waitUntil()。waitUntil()。注释解释代码本身无法表达的原因、协议约束、平台限制和失败策略，不逐句翻译代码。
JSDoc 使用中文说明，并准确包含必要的 @param、@returns 和真实存在的 @throws。
Promise.race() 的参与者和退出条件；TODO 格式：
// TODO(owner): 说明问题、触发条件和完成标准。
DataView 和 TypedArray 读取前检查边界。DNS_HEADER_LENGTH、TYPE_OPT、CLASS_IN。async / await。.then()。await：必须顺序尝试、共享 deadline 或需要短路时可以顺序执行。Promise.race() 代码必须清楚说明参与者、超时项、完成项移除和终止条件。AbortController 必须有明确所有者。finally 或统一 timer helper。AbortError 不记录为 error；其他异常不得静默吞掉。catch。upstream_timeout、invalid_dns_response。requestId、stage、upstream、qname、qtype、elapsedMs。console.log()。config.js 等生成文件；除非任务明确要求，不运行会覆盖它的命令。request.cf、bindings 和运行时 API 使用 Workers 测试池。{module}.test.js。重点测试：
package-lock.json。npm ci 验证干净安装。compatibility_date 更新前查阅官方变更并经过测试。git push、创建或合并 PR、部署 Worker、修改 Cloudflare 资源或生产配置。var、==、空 catch 和旧式异步写法。