用途:solid-react 是一个用于 React 组件架构的代码质量技能,目标是在实际编码中应用 SOLID 原则,统一文件拆分、接口组织、依赖注入和注释规范。它不是功能型技能,不替代 React API 相关的技能。
主要能力:按 SOLID 的五个原则分别提供独立参考指南,包括单一职责(按职责拆分文件、组件组合模式)、开闭原则(通过组合和插件架构扩展、render props 与插槽、策略模式)、里氏替换(接口约定、可替换实现、测试符合性)、接口隔离(角色化接口、props 分离、Context 拆分)、依赖倒置(构造注入、工厂模式、用 Context 做依赖注入)。另附 10 个可复制模板:组件、带 TanStack Query 的自定义 Hook、带依赖注入的服务、Zustand 持久化仓库(上限 40 行)、TypeScript 接口、Zod 校验、工厂、适配器、自定义错误类、Vitest 与 Testing Library 测试;模板均受文件行数上限约束。
使用方式:技能要求实现前先分析代码库,包括查看项目结构、阅读相关文件、识别命名与编码风格、理解数据流与依赖;再用 Grep 检索已有实现,优先复用或扩展到共享目录 modules/cores/lib/、components/、hooks/,重复三次以上的逻辑应抽取为共享函数。实现前要求并行启动三个代理分别探索代码库、核对技术栈最新文档、检查集成兼容性;实现后做验证。新文件创建后运行 npx jscpd ./src --threshold 3 检查重复。强制规则包括源文件不超过 FUSE_SOLID_MAX_LINES、接口放在 modules/[feature]/src/interfaces/、导出必须有 JSDoc(附示例签名)。
适用场景:适合需要按模块化结构组织 React 项目、控制文件体积、分离接口与业务逻辑、统一依赖注入和测试写法的团队与个人开发。
限制:资料未提供该技能的具体安装方式、版本要求、价格或性能数据,暂未提供。禁止事项包括未查文档即编码、使用过期 API、源文件超限、在组件文件中放接口、组件内写业务逻辑、使用 class 组件、导出缺 JSDoc、使用 any、桶文件重导出、用 useEffect 取数据、模块间互相引用(cores 除外)、未检索即重复实现工具函数、复制粘贴逻辑块。