用途:这是一个 React 项目脚手架技能,用于初始化新的 React 项目,或为现有 React 项目自动补全缺失的配置。
主要能力:先检测项目状态,包括是否为空目录、是否 Vite(存在 vite.config.ts/js)、是否 Next.js(存在 next.config.ts/js/mjs)、是否 TypeScript(存在 tsconfig.json 或 tsconfig.app.json)、是否已装 TanStack Query、Tailwind CSS、ESLint 配置、Prettier 配置、VSCode 设置,以及根据 lock 文件识别包管理器(pnpm-lock.yaml → pnpm,yarn.lock → yarn,bun.lockb/bun.lock → bun,package-lock.json 或无 → npm)。
使用方式:空目录时进入脚手架模式,询问用户选择 Vite(CSR)还是 Next.js(SSR),读取对应 reference 文件并执行创建命令,再应用全部通用配置;已有项目时进入补全模式,自动判断框架与安装状态,仅生成缺失配置。Vite 读取 references/vite.md,Next.js 读取 references/nextjs.md。缺失时生成 .prettierrc 与 .vscode/settings.json;缺少 TanStack Query 时用检测到的包管理器执行 {pm} install @tanstack/react-query 和 {pm} install -D @tanstack/eslint-plugin-query,并在 ESLint Flat Config 中加入 tanstackQuery.configs.recommended,随后在 Vite 的 src/App.tsx 或用 Next.js 的 src/app/providers.tsx 包裹 QueryClientProvider。
限制:不覆盖已存在的配置文件;仅在脚手架模式询问项目类型,补全模式不询问;空目录使用 npm。其余细节暂未提供。