代码cr:双审查员并行的前端代码评审 Skill

前言

前端 PR 往往要同时看 TypeScript 类型、Hooks 生命周期、异步竞态和组件边界,单靠一次泛泛的「帮我看看代码」,很容易漏掉某一类问题。人工对照团队 checklist 又费时,且不同审查者口径不一致。

下面介绍 SkillHub 社区 Skill「代码cr」(坐标 @user_dc5a82bd/fecodereview,当前版本 v1.0.2)。它把前端评审拆成固定维度,用双审查员并行跑一遍,再合并成分级发现和门控结论,适合在 Cursor 等支持 Skills 的环境里做提交前或 PR 前的结构化审查。

这是什么

「代码cr」是 SkillHub 上由发布者 user_dc5a82bd 维护的社区 Skill(分类 dev-programming,来源 community)。定位是前端代码评审:不替代本地 linter 或 CI,而是在 Agent 侧提供一套可重复的评审流程与输出格式。

SkillHub 页面标注 requires_api_key=false,安装与使用不依赖额外 API Key 配置。

核心功能

根据官方简介,该 Skill 的能力可概括为三点:

  1. 双审查员并行:两条审查路径同时执行,再在结论层合并,减少单一路径的盲区。
  2. 十六个评审维度:TypeScript 严格性、异步错误处理、代码结构、命名规范、组件设计、DRY 复用、状态管理、安全、依赖引入、注释可读性、无障碍访问、Hooks 正确性、内存泄漏、空值安全、CSS 质量、异步竞态。
  3. 结构化输出:输出分级发现,并给出合并后的门控结论(便于判断当前变更是否建议合并或需先修复)。

公开资料未列出各维度的具体打分规则或 severity 枚举;实际粒度以安装包内 SKILL.md 为准。

安装与启用

安装方式遵循 SkillHub 通用文档 skillhub.md。官方页面给出的安装提示为:按该文档安装坐标 @user_dc5a82bd/fecodereview。

1、确认 CLI

先检查本机是否已有 skillhub:

command -v skillhub && skillhub --version

若未安装,可使用官方安装脚本(完整安装含 CLI 与默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需 CLI 时:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装到当前 Agent 的 skills 目录

SkillHub 要求安装时必须用 --dir 指向当前 Agent 识别的 skills 目录,否则默认落在 ./skills/ 且可能不被加载。

skillhub install @user_dc5a82bd/fecodereview --dir <skills 目录>

常用路径(来自官方安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

不同客户端目录不同,请按你当前环境替换 <skills 目录>。安装后若 Agent 未立即识别新 Skill,可按客户端说明重启或刷新 Skills 列表。

公开页面未单独说明 Codex CLI 与 Claude Code 在触发方式上的差异;二者均以「Skill 安装到对应 skills 目录并被 Agent 加载」为前提。

典型用法

官方 SkillHub 页面未附带可复制的一键评审命令或示例仓库。经过上面的安装步骤后,典型流程是:

  1. 在已启用 Skills 的 Agent 会话中,指明待评审的前端代码范围(例如某个文件、目录或 git diff)。
  2. 说明需要进行代码评审或 CR,让 Agent 按已安装的「代码cr」Skill 执行。
  3. 阅读输出中的分级发现与合并门控结论,再决定修改或合并。

具体触发话术、是否必须引用文件路径、输出模板等,以安装包内的 SKILL.md 为准;本文不臆造示例 diff 或虚构评审结果。

适用场景与注意

适合:

  • 前端 TypeScript / React(及同类组件栈)变更的提交前自检。
  • 希望评审覆盖安全、a11y、Hooks、异步竞态等 checklist 项,而不是只问「有没有 bug」。
  • 团队已有 Agent + Skills 工作流,希望把 CR 口径固化成 Skill。

注意:

  • 简介明确面向前端评审;后端或非 UI 代码是否适用,官方未说明,不宜默认等同。
  • 双审查员与门控结论依赖 Agent 与 Skill 指令的执行质量,不能替代自动化测试与专用安全扫描。
  • SkillHub 统计(截至页面与抓取资料):评分 100000,下载 756 次,安装 4 次;社区 Skill,维护节奏以发布者为准。

结尾

「代码cr」把前端 CR 收成十六个维度、双路并行审查和分级门控结论,适合接到 Cursor 等环境的 Skills 目录里做结构化评审。安装与坐标以 SkillHub 为准:

  • Skill 页面:https://www.skillhub.cn/skills/user_dc5a82bd/fecodereview
  • API 坐标页:https://api.skillhub.cn/user_dc5a82bd/fecodereview
  • 安装说明:https://skillhub.cn/install/skillhub.md
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye