project-structure-enforcer

该技能用于按规范强制校验项目的文件夹结构，违规时以阻塞方式报错（exit 1）。主要规则包括：目录嵌套最多 4 层（从 src/ 或 app/ 算起，第 5 层及以上被阻止）；禁止 barrel 文件（index.ts 仅做 re-export），理由是影响 tree-shaking、易造成循环依赖、拖慢构建并增加调试难度；React 组件须放在 components/、features/ 或 app/ 目录（PascalCase .tsx），自定义 hook（useX 命名）须放在 hooks/ 目录；导入方向必须单向：shared/lib → components → features → app，低层不得反向依赖高层，也不允许跨 feature 相互导入；跨 feature 的 type-only 导入属例外允许。Python/FastAPI 侧同样约束文件位置：路由放在 routers/、业务逻辑放在 services/、数据访问放在 repositories/ 等。使用时该技能以检查器形式运行，对违规结构给出具体文件路径与修复建议，并提供迁移指南，如将 src/features/dashboard/widgets/charts/line/LineChart.tsx 拍平为 src/features/dashboard/charts/LineChart.tsx、改为直接导入替代 barrel 文件、把跨 feature 共享代码抽取到 shared/ 等。其资料中未提供具体安装命令或调用方式，暂未提供。相关技能包括 backend-architecture-enforcer、clean-architecture、type-safety-validation。适用范围以前端 React/Next.js 与后端 FastAPI 项目结构为限，其他技术栈未说明。