SuperAPI AI 工具集

nextjs-setup

编程与开发

查看项目

更新于 10-16 09:31

技能介绍

用途:在用户指定路径创建新的 Next.js 应用,或对已有 Next.js 项目做基线加固。开始前需先询问目标路径并解析为绝对路径,再判断该路径是否存在 Next.js 应用(package.json 中含 next,或存在 next.config.*、app/、pages/ 等文件)。修改文件前需阅读 references/baseline.md。

新建流程:先确保父目录存在,在父目录执行 bunx create-next-app@latest <app-directory-name>,除非用户另有偏好否则使用默认流程,然后套用基线。

已有项目流程:检查现有 package.json、锁文件、TypeScript、ESLint、Prettier、Tailwind、shadcn、AGENTS.md,保留项目特有依赖、脚本、端口、产品规则、环境处理与生成文件,只补充缺失或较弱的基线内容,例如仅用 Bun、严格 TS 标志、类型感知 ESLint、package.json 中的 Prettier 配置、非默认端口(通常 6474,冲突时另定)、bun run check 作为统一校验脚本、Tailwind 4 与 shadcn 默认值、App Router 元数据约定、以及基线 AGENTS.md 规则。

路径处理:若给出应用目录路径,以其父目录为工作目录、目录名为 <app-directory-name>;相对路径默认基于当前工作区解析;用户未给路径时不得臆造,只询问一次。

验证:确认生成目录存在并检查 package.json;新应用或更新后优先运行 bun run check,否则运行 bun run typecheck 与 bun run lint;用户要求时用 bun dev 启动开发服务器并提供本地 URL。

限制:不复制基线仓库中产品特有细节(如 Convex、认证、域名、线上测试脚本、功能导入限制),除非目标项目已使用或用户明确要求。