用途:对 React 代码库执行微层级代码质量审计,逐项比对 somnio-ai-tools 仓库中的 React 标准,聚焦单个组件、Hooks 与测试文件的实现质量,而非项目基础设施。
主要能力:覆盖七个步骤——测试质量(React Testing Library 与 Jest 命名、查询优先级、断言与异步处理、Arrange-Act-Assert、renderHook)、组件架构(基于特性的目录结构、文件大小与单一职责、barrel 导出、容器/展示分离、命名导出优先)、Hooks 模式(Hooks 规则、自定义 Hook 抽取与命名、useCallback/useMemo 稳定性、useEffect 依赖、useReducer 与 useState 取舍)、状态管理(本地状态到 Context、Zustand、TanStack Query 的选型)、性能(React.memo、代码分割、列表虚拟化、过早记忆化等反模式)、TypeScript 标准(严格配置、props 接口、避免 any、泛型组件与工具类型),最后汇总生成 Markdown 报告。
使用方式:标准文件优先读取仓库本地 agent-rules/rules/react/,否则用 WebFetch 从 GitHub raw 地址获取。在 Claude Code 会话中由 agents/orchestrator.md 统一入口,分三波派发子代理:第一波 cheap 层级做 TypeScript 与架构扫描,第二波 mid 层级做测试、架构、Hooks、状态与性能分析,第三波 frontier 层级写报告,每波确认产物存在后再推进。报告路径必须为 reports/<YYYY-MM-DD>-<project>-react-best-practices.md,项目名由 origin 远程 URL 推导;通过 somnio run 运行时以 CLI 传入的完整路径为准,不要重算,否则运行器找不到报告。
限制:所有结论必须基于代码证据,无法证明时写“Unknown”。报告须带 Report Metadata 元数据块。资料未提供安装命令、依赖要求与定价信息。