SuperAPI AI 工具集

project-structure

前端与建站

查看项目

更新于 10-16 05:47

技能介绍

用途:为 React、Next.js 或 TypeScript 项目提供基于功能(feature-based)的目录结构与代码归属决策,适用于新建应用或重构现有应用时判断文件应放在何处。

主要能力:给出基础结构,src/ 下分为 app/(路由、布局、providers)、components/(共享 UI)、features/(领域模块)、hooks/(共享 hooks)、lib/(库客户端与封装)、types/(共享类型)、utils/(共享工具);每个 feature 内部可含 api/、components/、hooks/、types/、utils/,只创建该功能实际用到的目录。同时提供代码归属规则、跨功能组合方式与导入边界判断。

核心规则:代码单向流动,即共享层 → 功能层 → 应用层;功能之间不可互相导入;应用层可组合多个功能;共享代码不可导入应用层或功能层;只添加当前需要的文件夹;仅被一个功能使用的代码移入该功能内。

使用方式:先识别领域或功能,再判断代码被单个还是多个功能使用;单功能代码放入对应 feature,复用代码放入共享目录;跨功能页面在 app 层组合;并可为导入边界添加 lint 规则。输出格式为 Project Structure Decision,包含 Code、Scope、Location、Reason 及 Import boundary(可导入来源、禁止导入来源)。

限制:资料未提供该技能的具体安装命令、运行时依赖、支持的版本范围、收费或价格信息。参考来源包括 Bulletproof React、Feature-Sliced Design 与 Next.js Project Organization。