前言¶
合并前或交付前,人工扫一遍目录往往耗时长,还容易漏掉规范细节、潜在缺陷和可读性问题。团队若有 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 官方简介,未在资料中出现的细节不作延伸:
- 规范性检查:对照约定与常见规范,指出不符合项。
- Bug 检测:在静态阅读范围内提示可能的逻辑或实现风险。
- 性能优化建议:给出可讨论的改进方向(非替代 profiling 工具)。
- 可读性评估:从结构、命名、复杂度等角度评价可维护性。
- 质量评分:结合华为 Java 编程规范给出评分维度,便于 Java 项目对齐企业规范。
- 审查报告:在对话中汇总上述结果,便于归档或跟进。
安装与启用¶
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 的对话中,可明确文件夹路径与期望输出,例如:
- 说明要审查的目录(相对或绝对路径均可,以 Agent 能访问为准)。
- 说明关注点:规范、Bug、性能、可读性,或需要完整报告。
- 若为 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