决策矩阵——项目检测与规则选择

检测顺序

按此顺序运行检测。每个步骤读取文件并设置后续步骤使用的标志。

1. 包管理器

检查锁文件：bun.lock→ bun，pnpm-lock.yaml→ pnpm，package-lock.json→ npm，yarn.lock→ yarn。

2. 项目类型

根package.json中的workspaces→ 单一代码库。否则 → 单一应用。

3. 框架

4. 单仓库工具（如果是单仓库）

5. 语言

tsconfig.json存在 → TypeScript。检查compilerOptions.strict: true→ 严格模式。

6. CSS 方法

7. 测试

8. 验证

9. ORM / 数据库

提供程序影响ID类型约定（PostgreSQL使用UUID，SQLite/MySQL使用自增，MongoDB使用ObjectId）。

10. 状态管理

服务器状态库（React Query、SWR）需要与客户端状态（Zustand、Redux）不同的规则。

11. API 客户端模式

12. 表单库

13. 认证库

14. 国际化库

15. 后端模式

16. 代码检查与质量

规则文件选择

将检测到的标志映射到规则文件以生成：

AGENTS.md 部分选择

根据检测生成的 AGENTS.md 中包含的部分：

命令生成

从package.json的scripts生成命令表。直接映射scripts键：

{"scripts":{"dev":"...","build":"...","lint":"...","test":"..."}}

变为：

为以下内容添加额外行：test:run（单次运行）、test:coverage、doctor、format、typecheck。

其中{pm}= 对于 bun（不带run的脚本）为bun，pnpm 为pnpm，npm 为npm run，yarn 为yarn。

Monorepo 命令生成

如果使用 Turborepo 的 monorepo：生成turbo run {cmd}变体。
如果使用 pnpm 的 monorepo：生成pnpm --filter {pkg} {cmd}示例。
如果使用 Nx 的单仓库：生成nx {cmd} {pkg}变体。

验证周期

从检测到的工具组装：

{typecheck} → {lint} → {test} → {doctor}

• {typecheck}：如果是 TypeScript，则使用tsc --noEmit，如果是 bun，则使用bunx tsc --noEmit，如果没有 TS 则跳过。
• {lint}:{pm} run lint或检测到的 lint 命令。
• {test}:{pm} run test:run或{pm} run test（取单次运行的那个）。
• {doctor}:{pm} doctor或{pm}x react-doctor@latest如果检测到 react-doctor。如果没有检测到则跳过。

单仓库重建说明

如果是带共享包的单一代码库：添加关于在循环之前重建包的说明：

Si se modificaron packages compartidos ({shared_pkg_list}), ejecutar su rebuild primero: {rebuild_commands}

特定框架的约定

Next.js 应用路由器

• 默认使用服务器组件。只有在使用钩子时才使用"use client"。
• 服务器操作在lib/actions.ts或src/actions/。
• error.tsx、loading.tsx、not-found.tsx按段落。
• generateMetadata()用于 SEO。
• next/image用于图片，next/font用于字体。
• 路径别名@/*→./*或./src/*。

Next.js 页面路由器

• getServerSideProps、getStaticProps、getStaticPaths。
• pages/api/用于 API 路由。
• pages/_app.tsx，pages/_document.tsx。
• 没有服务器组件。所有都是客户端或 API。

NestJS

• 模块像目录：src/{feature}/{feature}.module.ts。
• 带装饰器的 DTO。使用class-validator或ZodValidationPipe进行验证。
• 守卫用于身份验证：@UseGuards(AuthGuard)。
• PrismaService作为全局提供者。

边缘情况