简诗 AI 全栈代码审查助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/generic-fullstack-code-reviewer
技能介绍
要解决的问题
在 Next.js + NestJS 的全栈项目里,代码审查往往比单端项目更容易遗漏问题。前端要区分 Server Components 与 Client Components 的职责边界,后端要确认鉴权守卫、DTO 校验和数据库访问的安全,同时还要保证两端的类型与 API 契约一致。一次审查如果只看单侧,很容易出现这样的情况:后端返回结构变了,前端的类型定义还停留在上个版本;或者某条受保护路由忘了加守卫,直接暴露到公网。人工逐文件核对不仅耗时,还依赖审查者对两端技术栈都足够熟悉。
核心能力与工作方式
这个技能在基础代码审查方法论之上,为 Next.js 与 NestJS 的全栈组合增加了细化的审查规则。它继承 Generic Code Reviewer 的 P0/P1/P2 优先级体系,把发现的问题按严重程度分级,而不是把所有问题混在一起输出。
前端侧关注三个重点:
- Server vs Client Components 的职责边界是否正确
API Route的组织方式是否符合模式- 动态交互是否有对应的组件测试与 API mocking
后端侧围绕 NestJS 展开:受保护路由是否挂了 Auth Guards,请求 DTOs 是否覆盖了全部输入验证,有没有绕过 ORM/Prisma 安全默认行为的裸 SQL 查询。
跨栈一致性与生产级细节
跨栈一致性是这类技能最有价值的部分。它会检查共享类型是否在前后端对齐:请求 DTOs 是否匹配前端发出的 payloads,响应类型是否符合前端预期,错误响应格式是否统一(status、message、errors[] 三个字段的结构)。环境变量文件是否被误提交也在检查范围内。Prisma 方面关注几个容易踩的坑:migrations 是否可回滚、schema 改动后类型是否重新生成、Relations 定义是否完整。测试层面,后端要求 service 层有 unit tests、API endpoints 有 E2E tests、测试环境使用 mocked database;前端要求交互组件有对应的测试。
适用边界与注意点
这个技能专注 Next.js/NestJS 技术栈,其他框架或语言不在覆盖范围内。它带来的是规则化的静态检查与审查清单,不能替代对架构合理性的判断——比如某个业务模式是否该换一种数据流方案,仍需工程师自己决定。P0/P1/P2 的判定在边界情况下也需要人工复核。
使用场景
- Next.js + NestJS 项目合并 PR 前,检查受保护路由的 Auth guards 与 DTO 输入验证是否到位
- 前后端联调阶段,核对共享类型与 API 契约:请求 DTOs、响应类型与错误格式是否一致
- 代码审查中排查 .env 文件误提交、裸 SQL 查询与 Prisma migrations 可回滚性
- 提交前确认 Server/Client Components 边界正确,后端 service 层与 API endpoints 测试覆盖齐全
适合人员
- 全栈工程师:Review 自己的 PR 时需要集中核对鉴权、输入校验与前后端类型一致性
- 团队技术负责人:负责代码质量把关,需要统一 Next.js/NestJS 全栈代码审查标准
- 高级后端开发者:需要在评审中发现受保护路由缺少守卫或绕过 Prisma 使用裸 SQL 等隐患