SuperAPI AI 工具集

nextjs-standards

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:为 Next.js App Router 项目提供编码规范、验证协议与模板,在检测到 next.config.* 或 package.json 中存在 next 时自动加载。适用于新建项目、编辑 TypeScript/React 文件前、会话上下文丢失时,以及 /agent_reset 或 /vibe-primeAgent 之后。

主要能力:强制验证协议要求每次编辑 TS/TSX 后运行 npx tsc --noEmit,失败须立即修复并重跑,不得继续下一文件;交接前运行 python scripts/vibe-verify.py,全部通过才可声明完成。蓝图与构建协议分三阶段:编码前检查 docs/features/ 既有模式并创建或更新 FeatureName.md,等待批准;实现时声明所实现的 FR-XXX、引用 docs/issues/ 对应 issue、逐步实现并逐文件类型检查;收尾运行完整验证、更新 issue 状态并生成交接摘要。

规范要点:默认使用 Server Components,仅在需要交互、hooks 或浏览器 API 时使用 'use client';数据获取放在异步 Server Components 而非 useEffect;API 统一放在 app/api/.../route.ts;缓存需显式声明 { cache: 'no-store' } 或 revalidate = N。采用特性切片目录结构(app、features、components/ui、components/layout、lib、scripts)。组件限制 200 行、单一职责、使用 TypeScript 接口定义 props、状态逻辑抽为 use* 自定义 hooks。样式使用 Tailwind v4,通过 @import "tailwindcss" 与 @theme 令牌,不用 tailwind.config 扩展,暗色模式通过 html 上的 .dark 类。后端采用服务层模式,Route Handlers 作控制器,Services 承载业务逻辑,所有输入用 Zod 校验。

模板与命令:templates/ 提供 Coding_Guidelines.md 与 Issue_Template.md。常用命令包括 npx tsc --noEmit、python scripts/vibe-verify.py、npm run lint、npm run build。恢复协议使用 git status、git diff、git checkout -- <file>、git stash。

限制:资料未提供该技能的安装方式、收费信息、支持平台及实际效果数据。