代码审查:对指定目录做规范性检查与质量评估

前言

合并前或交付前,人工扫一遍目录往往耗时长,还容易漏掉规范细节、潜在缺陷和可读性问题。团队若有 Java 规范要求,还要对照文档逐项打分,更难在对话里一次性说清。

下面介绍 SkillHub 上的「代码审查」Skill(坐标 @user_6cc7d052/code-reviewer)。它在 Agent 侧按 SKILL 约定工作:对指定文件夹内的代码做结构化审查,并可在需要时产出审查报告,适合把「看代码质量、找问题、对规范」交给模型按固定维度执行。

这是什么

「代码审查」是社区来源(community)、由发布者 user_6cc7d052 维护的 dev-programming 类 Skill,当前版本 1.0.1。SkillHub 页面标注 requires_api_key=false,安装后一般无需额外配置 API Key。

一句话定位:对指定文件夹内的代码做全面审查,覆盖规范性检查、Bug 检测、性能优化建议、可读性评估,以及基于华为 Java 编程规范的质量评分;当需要审查代码质量、发现潜在问题、评估规范符合度或生成代码审查报告时使用。

核心功能

以下能力均来自 SkillHub 官方简介,未在资料中出现的细节不作延伸:

  1. 规范性检查:对照约定与常见规范,指出不符合项。
  2. Bug 检测:在静态阅读范围内提示可能的逻辑或实现风险。
  3. 性能优化建议:给出可讨论的改进方向(非替代 profiling 工具)。
  4. 可读性评估:从结构、命名、复杂度等角度评价可维护性。
  5. 质量评分:结合华为 Java 编程规范给出评分维度,便于 Java 项目对齐企业规范。
  6. 审查报告:在对话中汇总上述结果,便于归档或跟进。

安装与启用

SkillHub 推荐通过 CLI 安装,并必须用 --dir 指向当前 Agent 识别的 skills 目录;默认装到 ./skills/ 时,部分客户端不会自动加载。

1、检查或安装 SkillHub CLI

先确认本机是否已有 skillhub:

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

2、安装「代码审查」Skill

将 @user_6cc7d052/code-reviewer 安装到当前环境对应的 skills 目录。常见路径如下(以 SkillHub 安装文档为准):

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

示例(请把 <skills 目录> 换成实际路径):

skillhub install @user_6cc7d052/code-reviewer --dir <skills 目录>

SkillHub 技能页也提供等价的自然语言安装提示,核心是引用同一坐标与安装说明文档 https://skillhub.cn/install/skillhub.md:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_6cc7d052/code-reviewer`。

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

典型用法

公开资料未附带单独的 SKILL.md 全文或固定 CLI 子命令;用法与简介一致:指定目录 + 说明审查目标。在已启用该 Skill 的对话中,可明确文件夹路径与期望输出,例如:

  1. 说明要审查的目录(相对或绝对路径均可,以 Agent 能访问为准)。
  2. 说明关注点:规范、Bug、性能、可读性,或需要完整报告。
  3. 若为 Java 代码且需对齐华为规范,可明确要求「按华为 Java 编程规范评分」。

示例表述(可按项目改写路径与语言栈):

请使用代码审查 Skill,对 ./src/main/java 目录做全面审查,输出规范性问题和潜在 Bug,并给出基于华为 Java 编程规范的质量评分与改进建议;最后整理成一份审查报告。

经过上面的步骤,Agent 会按 Skill 内定义的流程组织输出;具体检查项以安装包中的 SKILL 说明为准。

适用场景与注意

适合谁

  • 需要在合并或发布前快速过一遍目录质量的个人或小团队。
  • 希望把 Java 规范检查与评分写进对话流程、减少手工对照文档的场景。
  • 需要结构化审查报告以便跟踪整改项时。

限制与注意

  • 审查对象是 Agent 能读到的文件夹内源码,不能替代专用静态分析器、测试或生产环境 profiling。
  • 「华为 Java 编程规范」相关评分主要服务于 Java;其他语言仍可受益于通用维度的 Bug、性能与可读性建议,但评分基准以 Skill 设计为准。
  • SkillHub 列表数据(截至页面抓取):评分 100000,下载 28410,安装 13;社区 Skill 的维护节奏与规则更新需自行关注版本 1.0.1 的后续升级。

结尾

「代码审查」把目录级审查、多维度建议和 Java 规范向评分收敛到一条 Skill 工作流里,适合在 IDE Agent 中按需触发,而不是另开一套独立审查服务。

官方入口:

  • SkillHub 页面:https://www.skillhub.cn/skills/user_6cc7d052/code-reviewer
  • API 坐标页:https://api.skillhub.cn/user_6cc7d052/code-reviewer
羽毛球分组比赛记分
小程序二维码

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

Xiaoye