SuperAPI AI 工具集

file-organization

编程与开发

查看项目

更新于 10-15 19:54

技能介绍

用途:在新建项目、项目复杂度上升需要重构、或团队需要统一目录规范时,帮助设计并落地一致的项目文件与文件夹结构。

主要能力:提供三类结构模板。一是 React/Next.js 结构,含 app 路由组、components(ui/layout/features/shared)、lib(utils/hooks/api)、store、types、config、styles;二是 Node.js/Express 后端结构,含 api(routes/controllers/middlewares)、services、repositories、models、database、utils、config、types、tests;三是大型应用的按功能划分结构,features 下每个功能自带 components、hooks、api、store、types,另有 shared 与 core。同时给出命名规范:组件 PascalCase.tsx,hooks 与 utils 用 camelCase.ts,常量 UPPER_SNAKE_CASE.ts,类型 camelCase.types.ts,测试 *.test.ts / *.spec.ts;文件夹可用 kebab-case、camelCase 或 PascalCase,强调全团队一致。还说明 index.ts 桶文件应使用具名再导出而非 export *,以免影响 tree-shaking;并给出 tsconfig.json 的 @/ 路径别名配置示例,用于简化导入。

使用方式:按项目类型选择对应模板,套用目录层级与命名规则;在 tsconfig.json 中配置 baseUrl 与 paths 后,用 @/components/ui 这类别名替代相对路径导入。

适用场景:新项目初始化、目录重构、团队规范统一。

限制与约束:要求全团队使用同一套规则;文件夹名需明确表达职责;目录深度建议不超过 5 层,避免 7 层以上嵌套;禁止 utils2/、helpers/、misc/ 等含糊命名;禁止循环依赖。资料未提供安装命令、收费信息与具体平台限制之外的细节。