用途:review-react 用于对指定代码范围内的 React 代码做框架层面的审查,只关注 React 框架约定,不定义审查范围(diff 还是整个代码库),也不做安全或架构分析。范围由调用方或用户提供。
主要能力:覆盖七个 React 维度:组件设计(函数组件、单一职责、组合模式、prop 类型与默认值、children 模式);Hooks 正确性(依赖数组、陈旧闭包、自定义 Hook 抽取、Hooks 规则、useEffect 清理);状态管理(本地与全局状态、Context、useReducer、Zustand/Redux 等外部 store、TanStack Query/SWR 服务端状态);渲染性能(memo/useMemo/useCallback、列表 key 稳定性、避免不必要重渲染、大列表虚拟化);副作用与数据获取(useEffect 模式、竞态条件、abort controller、加载/错误状态、数据获取库);路由与代码分割(React.lazy、Suspense 边界、基于路由的分割、错误边界);无障碍性(ARIA 属性、语义化 HTML、键盘导航、焦点管理、屏幕阅读器支持)。
使用方式:输入为包含 React 代码的文件、目录或 diff(.tsx、.jsx、.ts、.js 中使用 React API 的部分)。输出为符合 specs/findings-list.md 格式的零条或多条 findings,category 为 framework-react,每条都要引用具体 file:line 或组件名。
适用场景:作为 orchestrate-code-review 编排流程中的框架步骤;单独做 React 前端框架约定审查;PR 前的 React 检查清单。
限制:不做范围选择、安全分析(XSS、注入用 review-security)和架构分析(用 review-architecture),也不负责 JavaScript/TypeScript 语言或运行时约定。非 React 文件除非明确在范围内,否则不按 React 规则审查。所有 React findings 输出后交给 orchestrate-code-review 聚合;发现 XSS 风险(如危险地使用 dangerouslySetInnerHTML)时只记录并指向 review-security。每条 finding 必须带具体位置或可操作建议。