用途：作为 React 专用实现层，在保留项目既有 React 版本、包管理器、构建脚本、样式约定和路由模型的前提下进行开发，除非用户要求迁移。
主要能力：定义组件契约（页面/功能边界、输入输出、自有状态、服务端状态、加载/空/错误/成功状态、副作用）；实现显式数据流（局部状态、context 仅用于真正跨切面关注点、沿用既有服务端状态/缓存方案）；保持 UI 健壮（处理过期异步、取消请求、稳定 key、不修改 props/state）；面向浏览器（语义化 HTML、键盘可操作、可见焦点、响应式、稳定可访问名称）。
使用方式：先诊断再编辑，运行 scripts/react-doctor.py --json [PROJECT]，并查看 package.json、源码入口、Vite 配置、TypeScript 配置、路由与测试脚本。验证分层：先跑最窄的单元/组件测试，再 lint/typecheck，最后生产构建；浏览器级流程用 playwright，不用临时自动化。报告中给出确切命令与跳过的环境相关检查。
React 规则：Hook 必须无条件按相同顺序调用；Effect 用于与外部系统同步；下一状态依赖前一状态时用函数式更新；列表 key 用领域身份；事件处理与渲染计算分离；API 响应校验与转换留在集成边界。Vite 中仅用项目文档前缀（通常 VITE_）暴露有意公开的变量，禁将密钥放入客户端包。
适用场景：React/Vite 项目检查与诊断、组件边界与状态流设计、可访问 UI 实现。
限制：不随意添加状态库或路由；诊断脚本只读、不装包、不执行项目脚本、不联网、不打印环境值。组件架构、响应式、性能预算与一般前端测试移交 frontend-engineering；浏览器 E2E 移交 playwright；可访问性审计移交 web-accessibility；React Native/Expo/Android/iOS 移交 mobile-development。完成边界：实现变更并跑完相关检查即止，不擅自扩大为框架迁移或无障碍审计。