SuperAPI AI 工具集

folder-org

编程与开发

查看项目

更新于 10-16 08:09

技能介绍

用途:在创建文件、组织组件或判断代码应放在何处时提供目录结构参考,核心原则是就近放置(Colocation),即把代码放在与其最相关的位置,一起变化的内容应放在一起。

主要能力:给出多种组织方式。按功能组织(推荐用于前端)以领域分组,例如 src/features/auth/ 下含 components、hooks、auth.service.ts、auth.test.ts;按分层组织(常用于后端)以技术层分组,如 controllers、services、models、routes、middleware;Monorepo 使用 apps/ 放应用,packages/ 按领域而非语言放共享库,如 types、utils、ui。

常见文件位置:共享类型放 types/ 或 packages/types/;工具放 lib/ 或 utils/ 并按领域拆分;配置放 config/ 或根目录;单元测试就近放置,foo.test.ts 与 foo.ts 同目录;E2E 测试放 e2e/ 或 tests/e2e/;mock 与 fixture 放 mocks/ 或 test/mocks/。命名约定:文件用 kebab-case.ts,单元测试 *.test.ts,E2E 测试 *.e2e.ts,schema 用 *.schema.ts。

反模式:避免 utils.ts、helpers.ts 这类兜底文件;嵌套保持少于 4 层,用描述性名称代替;不要把单元测试统一放 tests/,应就近放置;Monorepo 中不要按语言分组;避免含 50 个以上再导出的臃肿 index.ts。

使用方式与限制:资料未提供安装命令、配置项或调用示例;具体适用范围与平台支持暂未提供。