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,强调全团队一致。变量与函数:组件 PascalCase,函数 camelCase,常量 UPPER_SNAKE_CASE,布尔值用 is/has/can 前缀。

使用方式:按模板建立目录;用 index.ts 桶文件做具名再导出,如 export { Button } from './Button/Button',避免 export * 影响 tree-shaking;通过 tsconfig.json 的 paths 配置 @/ 路径别名简化导入。

限制与约束:必须保持一致性、文件夹名称含义明确、目录深度建议不超过 5 层;禁止 7 层以上嵌套、禁止 utils2/helpers/misc 等模糊命名、禁止循环依赖。资料未提供安装命令、收费信息或具体平台限制之外的细节。