solid-generic 用于在开发 CLI 工具、库、脚本、hooks 或非框架 TypeScript 代码(Bun/Node.js)时,约束代码的组织方式和编写规范。
用途与定位 该技能针对非框架类 TypeScript 工程,强调遵循 SOLID 原则、先复用后新建、把接口与实现分离、导出必须带 JSDoc,并把文件规模控制在 FUSE_SOLID_MAX_LINES 以内。
主要能力
- DRY 复用检查:在写任何新代码之前,要求先在 codebase 中检索相似函数名、模式或逻辑,检查 modules/cores/lib/、modules/cores/interfaces/、modules/cores/errors/ 等共享位置;若已有相似代码则扩展或复用;若代码会被 2 个以上模块使用,则放入 modules/cores/;把重复出现 3 次及以上的逻辑抽取为共享 helper。
- SOLID 原则参考:单一职责、开闭原则、里氏替换、接口隔离、依赖倒置各有独立参考文档(single-responsibility.md 至 dependency-inversion.md),并提供 solid-principles.md 总览与 architecture-patterns.md 项目结构说明。
- 代码模板:提供 module.md(TypeScript/Bun 模块)、service.md(带依赖注入的服务)、interface.md(TypeScript 接口)、validator.md(Zod 校验 schema)、factory.md(工厂模式)、error.md(自定义错误类)、test.md(Bun test / Vitest)等模板,可以直接复制使用。
- 强制规则:文件不超过 FUSE_SOLID_MAX_LINES,并在达到上限前拆分混合职责;每个模块、服务和校验器只承担单一用途;接口放在 modules/[feature]/src/interfaces/ 或 modules/cores/interfaces/,不得写入实现文件;禁止扁平 src/ 结构,必须使用 modules/;导出函数必须带 JSDoc(含 @param、@returns、@throws);禁止 any 类型、barrel exports(index.ts 再导出)以及未先检索就重复已有工具函数。
- 智能体工作流:实现前并行启动 3 个智能体,即 fuse-ai-pilot:explore-codebase(分析项目结构与现有模式)、fuse-ai-pilot:research-expert(通过 Context7 核对最新 TypeScript/Bun 文档)、mcp__context7__query-docs(检查集成兼容性);实现后运行 fuse-ai-pilot:sniper 进行校验。
使用方式 把该技能用于编写新代码、重构或评审 TypeScript/Bun/Node.js 项目时,按上述顺序执行:先做 DRY 检索与共享代码位置检查,再参照 SOLID 文档与模板编写代码,最后运行验证智能体。
适用场景 CLI 工具、库、脚本、hooks、非框架 TypeScript 代码库,以及需要统一模块边界、接口组织与注释规范的 Bun/Node.js 项目。
限制 资料未提供该技能的安装命令、许可协议、具体收费方式和性能数据;FUSE_SOLID_MAX_LINES 的具体数值暂未提供;所涉智能体与 Context7 集成的具体配置方式暂未提供。