SuperAPI AI 工具集

react-hook-authoring-fix

前端与建站

查看项目

更新于 10-15 20:05

技能介绍

用途:审计自定义 React Hook(以 use 开头且内部使用 React Hook 的函数),依据 react-hook-authoring 技能的原则检查过度设计、memoization 问题、消费者开发体验问题与已知反模式,并应用修复。

主要能力:按 9 项检查逐文件审计,包括过早 useCallback、在 state updater 中产生副作用、渲染期间写 ref、强制消费者 memoization、过度设计模式、对原始值使用 useMemo、useCallback 未配合子组件 memo、不稳定的 context value、缺少 Object.is 检查。每项问题记录行号、检查编号、严重级别(high/medium/low)、问题代码与建议方案。

使用方式:先解析参数为文件路径或 glob;未提供时询问要审计的 Hook 文件。随后读取 ../react-hook-authoring/SKILL.md 与 references/approaches.md;若为单技能安装则直接调用 react-hook-authoring 技能,若未安装则停止并告知依赖。修复分三类:可自动修复(移除不稳定依赖的 useCallback、移除原始值 useMemo、为 context value 加 useMemo)、半自动(将 onChange 移出 state updater、用 useLayoutEffect 替代渲染期写 ref、简化过度设计为 Approach A、加 Object.is 守卫)、仅手动报告(消费者 memoization 要求、useCallback 未配合 memo、存在 context 消费者时从 Approach B 切回 A)。修复按文件内行号自底向上应用,最后输出审计报告,含文件数、问题数、表格、已应用变更与需人工复核项,并建议运行 pnpm type-check && pnpm test 验证。

适用场景:需要批量审查或修复 React 自定义 Hook 代码质量时。

限制:依赖 react-hook-authoring 技能;部分修复需消费者侧改动或性能分析,仅报告不自动修改;资料未提供具体安装命令、收费与平台信息。