多轴代码评审:合并前从五个维度做代码审查

前言

PR 越堆越大、diff 里混着功能、重构和依赖升级时,人工 review 很容易漏掉安全或性能问题;只让模型「看一眼代码」又往往只停留在风格层面。下面介绍一个在合并前按固定维度走一遍的 Agent Skill,把正确性、架构、安全等检查收敛成可重复的流程。

这是什么

多轴代码评审(SkillHub 坐标 @org-b6kzcl68/code-review-and-quality,版本 1.0.0)是 SkillHub 上分类为 dev-programming 的企业来源 Skill,由重庆途光网络传媒有限责任公司发布。页面标注 requires_api_key=false,安装与使用不依赖额外 API Key。

它面向「任何变更进入主分支之前」:对自己、同事或 AI 生成的代码做多维度质量评估,而不是单次对话里的随意点评。SkillHub 简介将其定位为合并前必做的多轴评审,并写明适用时机为合并 PR 或变更之前、功能实现完成之后、需要评估多方代码质量时。

官方入口:

  • SkillHub 页面:https://www.skillhub.cn/skills/org-b6kzcl68/code-review-and-quality
  • API 资料页:https://api.skillhub.cn/user_e40a4360/code-review-and-quality

核心功能

依据 SkillHub 已公开的简介,该 Skill 的能力可归纳为以下几块(均以官方描述为准):

  1. 五维评估:对每一处变更从正确性、可读性、架构、安全、性能五个维度审查。
  2. 变更拆分策略:在评审流程中纳入如何拆分变更的建议(与「大 PR 难 review」的场景对应)。
  3. 评审清单:提供结构化清单,便于 Agent 按项检查而非自由发挥。
  4. 死代码清理:评审时覆盖无用代码的识别与清理纪律。
  5. 依赖升级纪律:在涉及依赖变更时,按 Skill 内规则做升级相关评审。

触发语境(官方 Triggers 列举):代码评审、review diff、review PR、代码质量检查、合并前评审、重构评估、依赖升级评审、死代码清理。在 Cursor 等支持 Skills 的客户端里,用上述自然语言描述任务即可让 Agent 加载该 Skill 的 SKILL.md 并按其中步骤执行。

安装与启用

SkillHub 推荐两种方式:用 CLI 安装,或把安装提示词发给当前 Agent。

1、安装 SkillHub CLI(若尚未安装)

先检查是否已有 CLI:

command -v skillhub && skillhub --version

未安装时,可按 SkillHub 安装文档执行完整安装(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

说明见:https://skillhub.cn/install/skillhub.md

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

安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录,否则默认会装到 ./skills/,客户端可能识别不到。

skillhub install @org-b6kzcl68/code-review-and-quality --dir <你的 skills 目录>

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

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

也可直接向 Agent 发送 SkillHub 页面上的安装提示词:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@org-b6kzcl68/code-review-and-quality`。

安装完成后,按你所用客户端的要求重启或刷新 Agent,使新 Skill 生效。

典型用法

本 Skill 遵循通用 SKILL.md 格式:启用后由 Agent 读取技能说明,再结合你提供的上下文(diff、分支、PR 描述等)执行评审。下面是可以直接复现的对话入口,均来自官方 Triggers 与 Use when 描述。

  1. 合并前看 diff
    在已安装 Skill 的项目或全局 skills 下,对 Agent 说:「对当前 git diff 做合并前评审,按正确性、可读性、架构、安全、性能五个维度检查。」

  2. Review PR
    「review PR:列出必须修复项与建议项,并说明变更是否应拆分。」

  3. 重构或依赖变更
    「这是一次重构评估 / 依赖升级评审,请按 Skill 里的依赖升级纪律和死代码清理要求审查变更。」

  4. AI 生成代码自检
    功能实现完成后:「评估刚提交的代码质量,准备合并到主分支前。」

经过上面的步骤,Agent 会按 Skill 内清单与五维框架输出结论;具体条目以安装包中的 SKILL.md 为准,本文不展开未在公开简介中出现的工作流细节。

适用场景与注意

适合谁

  • 需要在合并 PR 前统一评审标准的小团队或个人开发者。
  • 经常处理 AI 辅助生成代码、希望 review 不只盯语法和命名的场景。
  • 变更里常夹杂重构、依赖升级,需要单独纪律检查的情况。

限制与注意

  • SkillHub 页面当前显示版本为 v1.0.0;评分、下载量等会随商店更新变化,以页面为准(资料抓取时评分为 100000,下载 23 次)。
  • 该 Skill 是评审流程与清单,不替代 CI 里的自动化测试、静态分析或安全扫描;五维中的「正确性」「安全」仍应与你仓库里的工具链配合。
  • 安装路径错误是常见坑:务必 --dir 指向 Cursor 等客户端的 skills 目录。
  • 官方简介末尾带有「淘宝搜索 AI灵匣」等发布方信息,与技能能力无直接关系,安装时以 SkillHub 坐标与安装文档为准即可。

结尾

多轴代码评审把合并前的代码质量检查固定为五个维度,并附带变更拆分、清单、死代码与依赖升级等纪律,适合在 PR 合并前、功能完成后或 review AI 生成代码时启用。安装与详情见 SkillHub:https://www.skillhub.cn/skills/org-b6kzcl68/code-review-and-quality

羽毛球分组比赛记分
小程序二维码

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

小夜