SuperAPI AI 工具集

project-structure

通用与其它

查看项目

更新于 10-15 19:48

技能介绍

用途:帮助决定代码应放在何处、整理文件,或审计项目结构。默认行为是审计并报告;只有用户明确要求修复、重组或应用改动时才移动文件。需求不清晰时先报告,再提出可代为应用的修复。

主要能力:按规则检查项目结构,规则包括同置(HIGH)、反模式(HIGH)、基于功能分组(MEDIUM)、基于分层分组(MEDIUM)、框架结构(MEDIUM,仅在检测到受支持框架时启用,目前为 Next.js / Expo)。

工作流程:第一步检测项目类型——功能密集型应用(SPA、Next.js/React 或任何 UI 驱动代码库)用基于功能分组;服务/API(Express、Fastify、Hono、Django、FastAPI、Go、Rails 等)用基于分层分组;Monorepo(apps/ + packages/ 或工作区清单)用混合方式;已有结构则尊重并沿用现有模式。第二步审计,按路径—问题—修复的格式报告,归入 HIGH / MEDIUM / LOW,并给出每条规则的违规计数。第三步建议新代码位置,默认放在其唯一消费者旁边,出现第二个消费者时提升到共享位置,扩展现有结构而非另起一套。第四步修复:目标目录不存在时先 mkdir -p <dest>,再用 git mv 移动文件,更新依赖文件的导入路径,并确认没有残留的失效导入。

适用场景:代码库结构梳理、新代码放置决策、目录反模式排查。限制:框架结构规则仅覆盖 Next.js / Expo;其余情况使用语言无关的同置与分组规则。具体安装与调用方式暂未提供。