前言¶

合并前做一次代码评审，常见做法是人工对着 diff 扫一遍，再对照需求或设计文档核对业务是否对齐。文档在 Confluence、Word 或仓库外的 ./review/ 里，diff 在 Git 里，两边来回切换，容易漏掉边界条件、并发或安全相关的问题。下面介绍 SkillHub 上的「代码评审」Skill：在 Agent 里用自然语言触发后，会主动读设计文档、比对当前分支与 Master 的差异，并按固定维度输出评审报告。

这是什么¶

「代码评审」是社区发布者 user_c19c8ed5 在 SkillHub 上架的 Agent Skill，坐标为 @user_c19c8ed5/awesome-code-review，当前版本 1.0.0，分类为 dev-programming，来源标注为 community。页面标签标明 requires_api_key=false，安装本 Skill 本身不依赖额外 API Key。

它面向「要做深度 CR、又希望报告结构统一」的场景：不只列变更文件，还会结合仓库内 ./review/ 下的需求文档，以及当前分支相对 Master 的 Git 差异，从业务逻辑、架构与安全、并发与性能等角度给出结构化结论，并明确参照《阿里巴巴 Java 开发手册》的评审口径（Skill 简介中的表述）。

核心功能¶

以下能力均来自 SkillHub 官方简介与页面说明，未在资料中出现的细节不展开。

1. 触发方式
   当用户提出「代码 Review」「CR」、评审代码、分析分支差异、查看变更等意图时，Skill 会被选用。

2. 读取设计 / 需求文档
   会主动加载项目根目录下 ./review/ 中的文档，支持 .docx 与 .md 等格式（以简介为准）。

3. Git 分支比对
   分析当前分支与 Master 之间的差异，作为评审输入。

4. 深度评审维度
   在简介中承诺覆盖：业务逻辑、架构与安全、并发与性能；评审规范对齐《阿里巴巴 Java 开发手册》。

5. 输出形态
   生成结构化评审报告，便于归档或贴进 MR/PR 讨论。

安装与启用¶

SkillHub 提供两种常见安装路径：把安装说明交给 AI 执行，或使用 skillhub CLI 安装到当前 Agent 的 skills 目录。安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被 Agent 加载。

方式一：提示词交给 AI¶

将下面这句话发给支持 SkillHub 安装流程的 AI（安装步骤以官方文档为准）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_c19c8ed5/awesome-code-review`。

方式二：skillhub CLI¶

先确认本机是否已安装 CLI（摘自 SkillHub 安装文档）：

command -v skillhub && skillhub --version

未安装时可按官方文档执行完整安装或仅安装 CLI；装好后安装本 Skill，并把 --dir 换成你当前环境的路径。例如 Cursor 常用目录为 ~/.cursor/skills/：

skillhub install @user_c19c8ed5/awesome-code-review --dir ~/.cursor/skills/

同一文档还列出 Claude Code（~/.claude/skills/）、Codex（~/.codex/skills/ 或项目下 .agents/skills/）等路径；其他客户端按文档中的「常用 AI Client 的 Skills 路径」自行对应。安装后若 Agent 未立刻识别新 Skill，可按客户端要求重启或刷新技能列表。

典型用法¶

资料中没有单独的「一键示例仓库」，但简介中的工作流可以按步骤复现。

1. 准备需求文档
   在仓库根目录创建 review/，放入与本次变更相关的 .md 或 .docx 需求、设计说明。

2. 在功能分支上开发
   确保本地 Git 仓库存在 Master 基准分支，当前工作在待评审的功能分支上。

3. 在 Agent 中发起评审
   用自然语言说明意图即可，例如：

   请对当前分支做代码 CR，对比 Master，结合 review 目录下的需求文档输出结构化评审报告。

4. 阅读报告
   根据报告中的业务逻辑、架构安全、并发性能等条目，回到代码中修改或补充测试，再按需重复评审。

适用场景与注意¶

适合谁

• Java 或遵循《阿里巴巴 Java 开发手册》规范的后端团队，希望在 MR 前多一层「文档 + diff」联动的检查。
• 已在 Cursor、Claude Code、Codex 等支持 Skills 的环境里做日常开发，希望用同一套话术触发 CR。

使用上需要注意

• 评审质量依赖 ./review/ 文档是否完整、Git 与 Master 的对比是否反映真实合入范围；文档缺失或分支基准不对，结论可能偏空或偏题。
• Skill 为社区来源（community），具体检查项与报告模板以安装后的 SKILL.md 为准；本文仅归纳 SkillHub 页面上的公开描述。
• SkillHub 页面统计（截至抓取）：评分 100000，下载 2130；与第三方转载的其它数字不一致时，以 SkillHub 为准。

结尾¶

「代码评审」把需求文档目录、Master 分支 diff 和结构化报告串成一条 Agent 工作流，适合在合入前做一轮有章法的 CR。安装与坐标以 SkillHub 为准：

• 技能页：https://www.skillhub.cn/skills/user_c19c8ed5/awesome-code-review
• API 条目：https://api.skillhub.cn/user_c19c8ed5/awesome-code-review