SuperAPI AI 工具集

generic-code-reviewer

编程与开发

查看项目

更新于 10-16 10:40

技能介绍

用途

Generic Code Reviewer 是一个通用代码审查技能,用于对照生产质量标准审查代码,并可适配任意项目的技术栈。它适用于以下场景:完成功能开发时、提交代码(commit)之前,或审查拉取请求(pull request)时。

主要能力

该技能覆盖多个审查维度:

  • CLAUDE.md 合规性:始终检查项目 CLAUDE.md 中的具体规则。在任何提交之前,要求任务文件存在于 tasks/[feature-name].md;对照需求、调用方和边界情况审查 diff;无控制台错误或警告;打包体积在限制范围内。
  • 技术栈检测:根据项目文件自动识别技术栈并应用对应检查。检测到 package.json 中的 React 时按 React/TS 检查组件、hooks、状态;检测到 Next.js 时检查 SSR、API 路由;检测到 NestJS 时检查 Guards、DTO、服务;存在 .html 文件且无构建时按原生方式检查语义化 HTML 与最小化 JS;存在 .py 文件时按 Python 检查类型提示与校验。
  • P0 问题(阻断合并):包括前端安全(使用 textContent 而非 innerHTML 进行输入净化、外部数据使用 unknown 类型、不暴露 API 密钥、外部请求使用 HTTPS)、后端安全(所有端点进行输入校验、受保护路由进行鉴权、使用参数化查询而非原始 SQL、密钥存放于环境变量)、正确性(破坏功能的逻辑错误、严格模式下的类型错误、未处理的 promise 拒绝)。
  • P1 问题(应当修复):包括性能(静态站点 < 50KB 不含媒体、SPA/React 初始 gzip < 100KB、全栈初始 gzip < 200KB;动画仅使用 GPU 加速的 transform 和 opacity、目标 60fps、使用 requestAnimationFrame)和无障碍(WCAG AA:交互元素有焦点指示、支持键盘导航 Tab/Enter/Escape、颜色对比度 >= 4.5:1、纯图标按钮有 ARIA 标签、有意义的图片有替代文本、语义化 HTML 结构)。
  • P2 问题(可选优化):代码质量方面,包括 DRY、单一职责、无魔法数字/字符串、自文档化代码、遵循既有模式、无注释掉的死代码。

使用方式

该技能以审查输出格式呈现结果,仅报告发现的问题,不列出空类别:

  • Blocking Issues (P0):仅在发现安全、正确性问题时列出。
  • Should Fix (P1):仅在发现性能、无障碍问题时列出。
  • Consider (P2):仅在发现代码质量打磨项时列出。
  • 若无问题:输出“Code review passed. Ready to merge.”

在用户询问“这样行吗?”时,技能会进行判断:根据环境(生产更严格、原型/POC 更宽松)、路径(热路径更严格、一次性设置或仅管理员更宽松)、可见性(公共 API 更严格、内部辅助方法更宽松)、时间线(功能完成更严格、活跃迭代更宽松)调整严重程度。P0 安全问题永不宽松。

快速检查清单:提交前审查 diff(输入、边界情况、错误路径、调用方)且无控制台错误;合并前所有 P0 问题已解决、P1 问题已处理或跟踪、P2 问题记录以备后续。

适用场景

适用于任何技术栈项目的代码审查,尤其适合在功能完成、提交前和拉取请求审查环节使用,帮助团队按生产质量标准把控代码。

限制

该技能的具体实现细节、安装方式、收费情况、价格、平台支持等信息暂未提供。其完整标准参见 Code Review Standards 文档,UI 一致性参见 Design Patterns 文档,工作流规则参见项目 CLAUDE.md。