技能介绍

问题从哪来

React 仪表盘在鉴权、订阅 tier、onboarding 和 API 环境切换叠在一起时，很容易出现「本地看起来正常、上线后某类用户看到错 tier、错价格或 dev 残留」的问题。常见诱因包括：组件直接从 auth provider metadata 读 tier、UI 里硬编码 localhost 或占位邮箱、base/paid 用户的 mode 默认值不一致，以及生产构建里仍留着 debug 或 mock 登录组件。

技能如何工作

dashboard-pre-flight 把发布前检查整理成可重复执行的审计会话，而不是零散 grep。会话开头可配置 AUDIT_RUNS：修复上一轮问题、首次审计遗留代码、或 auth/tier 大改后，建议设为 2 及以上，直到单轮不再产生新问题再继续。

核心是一条 Audit Checklist，覆盖八块：

Tier 处理：tier 只从根/App 经 prop 下发，展示逻辑里不做 metadata 直读；fallback 仅在 prop default。
硬编码扫描：用户可见输出无占位邮箱、无 dev URL、TODO/FIXME 进 issue 而非留在代码。
Mode/偏好：base 默认 restricted、paid 默认 full，偏好持久化并同步后端。
Onboarding：集成后不再展示外部 install 命令，示例 URL 用文档域而非 IP。
API 与定价：调用走导出常量，价格来自后端或配置。
陈旧组件与鉴权链：生产无 debug/mock，fallback 止于 unauthenticated，无 dev bypass token。

审计结束用表格记录 Fixes Applied，再按文档中的 Verification Steps 走新用户 signup、升级 tier、核心流程与 Lighthouse（目标各分类 90+）。

适用边界

清单与 --include="*.jsx" 等路径默认面向 React；Vue/Svelte、Next.js 的 pages//app/、React Native 与 monorepo 需按 Adaptation Notes 调整扫描范围。非 React 栈可借鉴检查项，但文件 glob 与目录结构要自己改。