SuperAPI AI 工具集

nextjs-code-review

前端与建站

查看项目

更新于 10-15 21:52

技能介绍

用途:对 Next.js App Router 代码进行系统性代码审查,评估是否符合最佳实践与生产就绪标准,产出按严重程度分类的可执行发现,并可委托 typescript-software-architect-review agent 做架构分析。

主要能力:检查 Server Component 与 Client Component 边界('use client' 是否必要且尽量下沉);审查数据获取模式(fetch 的 cache/revalidate 选项、Promise.all 并行、避免请求瀑布、避免向客户端泄露敏感数据);评估缓存策略(静态生成、ISR、动态渲染、generateStaticParams、revalidatePath/revalidateTag、API 路由缓存头);审查 Server Actions 的校验、错误处理、useOptimistic 与授权安全;检查 middleware 的匹配范围、认证逻辑与性能影响;审查 generateMetadata、Open Graph、结构化数据、robots.txt 与 sitemap.xml;检查 loading、error、not-found 页面实现。

使用方式:先确定审查范围,用 glob 发现 page.tsx、layout.tsx、loading.tsx、error.tsx、route.ts、middleware.ts 等文件;逐项分析组件边界、数据获取、缓存、Server Actions、中间件、元数据;在定稿前核对实际代码上下文以剔除误报;最后输出结构化报告,含总体质量评分(1-10)、Critical/Warning/Suggestion 分级发现、正面观察与带代码示例的优先建议。

适用场景:合并前审查页面、布局与路由段;验证组件边界;检查 Server Actions 安全与正确性;评估缓存与数据获取;审查中间件与 API 路由;校验 SEO 元数据;从 Pages Router 迁移后复查。

限制:仅针对 App Router,Pages Router 模式差异较大;需尊重项目 Next.js 版本;除非明确要求,不建议从 Pages Router 迁移;缓存行为在开发与生产环境不同,需在生产构建中验证;Server Actions 不得在缺少认证检查时暴露敏感操作;应聚焦高置信度问题,避免风格偏好类误报。具体安装命令与收费信息暂未提供。