前言¶
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 的能力可归纳为以下几块(均以官方描述为准):
- 五维评估:对每一处变更从正确性、可读性、架构、安全、性能五个维度审查。
- 变更拆分策略:在评审流程中纳入如何拆分变更的建议(与「大 PR 难 review」的场景对应)。
- 评审清单:提供结构化清单,便于 Agent 按项检查而非自由发挥。
- 死代码清理:评审时覆盖无用代码的识别与清理纪律。
- 依赖升级纪律:在涉及依赖变更时,按 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 描述。
-
合并前看 diff
在已安装 Skill 的项目或全局 skills 下,对 Agent 说:「对当前git diff做合并前评审,按正确性、可读性、架构、安全、性能五个维度检查。」 -
Review PR
「review PR:列出必须修复项与建议项,并说明变更是否应拆分。」 -
重构或依赖变更
「这是一次重构评估 / 依赖升级评审,请按 Skill 里的依赖升级纪律和死代码清理要求审查变更。」 -
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