用途
该技能用于 React 应用的性能优化与最佳实践指导,面向 AI 代理和 LLM。它强调在编写组件、hooks、JSX,进行重构,以及审查 React 代码时始终使用该技能。
主要能力
技能列出了多个关键反模式(“NEVER Do React”),包括:不要在组件内部定义组件;如果只在回调中读取 searchParams/localStorage,不要订阅它们;不要在 useEffect 中使用对象或数组依赖;不要用 useState + useEffect 同步派生状态;不要在 SSR 组件中直接使用仅客户端状态;不要在 React 19+ 中使用 forwardRef;不要向内联 memoized 组件传递内联回调、对象或数组;不要把用户交互逻辑放入 useEffect。
在提出 memo/useMemo/useCallback 优化前,需要先判断项目是否使用 React Compiler,是否真的存在性能问题,以及规模如何。
使用方式
技能采用渐进式披露结构以减少上下文占用。首先阅读 AGENTS.md 获取所有规则的一行摘要概览;然后根据需要加载具体规则文件,分为重渲染优化、渲染性能、高级模式、杂项和快速参考等类别;每个参考文件包含错误示例、正确示例和原因说明;最后可应用报告模板生成标准化审计报告。
触发审计模板的场景包括:直接通过 /accelint-react-best-practices <path> 调用技能;用户要求“review code quality”或“audit code”。不适用报告模板的场景包括:用户要求修复具体类型错误;用户询问某段代码有什么问题;用户请求具体修复。
适用场景
适用于 React 组件编写与重构、hooks 与 JSX 开发、性能瓶颈排查、SSR 水合问题、重渲染优化、过期闭包修复等。技能中给出了三个示例:优化频繁重渲染、修复过期闭包、SSR 水合不匹配。
限制与注意事项
技能强调每条参考文件展示一种经过验证的模式,但 React 问题常有多种有效解法;应结合用户的 React 版本、项目复杂度和团队偏好。对于简单场景,可建议更简单的方案。使用前应检查项目是否启用 React Compiler:若启用,跳过手动 memoization,但仍应用状态、effect 和 CSS 优化;若未启用,则应用所有相关优化。技能覆盖 React 19 特性,包括 useEffectEvent、<Activity> 组件、ref 作为 prop、仅命名导入。性能哲学是先写正确代码再优化,测量后再优化,优先优化最慢操作。价格、收费、平台等具体信息暂未提供。