Human Review Skill：让 AI Code Review 变成一页可点击的专业报告

Skill超级捕获手 技术创作者 2026-10-05 13 阅读

总结

Human Review 是一个为 Claude Code 定制的 /human-review Skill——当 AI 完成一个代码分支后，运行这条命令会生成一份多标签页的单页面 Review Report，涵盖行为变更、REST 协议、数据模型、测试覆盖、序列图、代码复杂度、3D Code City 等十余个维度。每一行代码引用都直链编辑器，每个 Snippet 均从构建时的实际工作树提取，确保 Review 页面与代码永远同步不漂移。它解决的是 Code Review 场景中「人工阅读散落在 PR 描述、代码 diff、测试报告、API 文档里」的效率痛点——2026 年 10 月 4 日刚上 GitHub Trending，是目前 Claude Code Skill 生态里最垂直的 Review 加速器之一。

功能与原则

核心功能是自动化 Review 页面生成：运行 /human-review，Claude Code 自动搜集分支信息，生成一个包含 10+ 标签页的 HTML 页面，每个标签对应一个 Review 维度：

  • Review 概览：Agent 拒绝/修复/假设了什么，带 diff 标注
  • 行为验证：Playwright 录制回放，带时间戳字幕的功能演示视频
  • REST 协议变更：每条接口按 breaking/additive/changed/cosmetic 四级分类
  • 数据层变更：数据库和领域模型 diff，增量绿色、删除红色+删除线
  • 测试覆盖：每个需求句子 → 对应测试用例 → 本次运行结果
  • 序列图：从真实测试运行轨迹中提取的时序图
  • 代码结构：包/容器 diff，或当前上下文图
  • Code City：3D 城市视图，类=楼，体积=代码行数，颜色=代码 churn
  • 复杂度增量：每个入口点的认知复杂度前后对比
  • 日志审计：变更集中所有日志语句，标注是否含个人数据
  • CODEOWNERS：当前审批人和合流阻塞状态

设计原则：
1. 零漂移：页面从工作树构建时实时提取，不引用 PR 描述，不依赖人工维护
2. 编辑器和 Review 联动：每个代码引用都是可点击的编辑器深链接
3. 按维度隔离：审查者按问题类别逐一过标签，不在信息洪流中迷失
4. 自动化截图 + 录制：行为验证标签嵌有 Playwright 视频，无需人工跑测试

认可度

GitHub 仓库 victorrentea/human-review 于 2026 年 10 月 4 日出现在 GitHub Trending（trending-claude-skills 实时追踪列表），当时约 11 stars，属于典型「新晋冷启动」仓库，增长速度较快。Skill 已被 SkillsMP 收录（2026-09-15 收录），创作者 victorrentea 为资深 Java Champion/IBM 前 Lead Architect，在 GitHub 有大量公开培训代码和技术内容。

链接

GitHub：https://github.com/victorrentea/human-review

在线 Demo（无需安装，直接在浏览器体验）：https://victorrentea.github.io/human-review/demo/review.html

原作者

Victor Rentea（GitHub @victorrentea）——资深 Java Champion，曾任 IBM Lead Architect，2012 年起从事开发者培训与咨询，在 GitHub 拥有多个教学代码仓库，专注于 Clean Code、Clean Architecture、Testing 等领域。其训练营风格的 Skill 输出在社区有较高认可度。

介绍

传统的 Code Review 依赖人工翻阅：PR 描述告诉你「做了什么」，diff 告诉你「改了什么」，测试报告告诉你「跑了什么」，API 文档告诉你「预期是什么」——但这些信息散落在不同工具里，审查者需要来回跳转、上下文切换，信息整合成本极高。

Human Review 的思路是：让 AI 在提交 Review 之前，把所有 Review 维度聚合成一份自包含的 HTML 页面，每一个标签页对应一个专业视角，审查者按问题类型逐一扫过，不需要自己在多个工具之间手动拼接信息。

该 Skill 从 victorrentea 的真实项目提取，曾在实际分支 Review 循环中使用过一段时间后才独立成可移植的 Skill。这意味着每个标签的设计都来自真实工作流中的实际痛点，而不是概念设计。

安装后直接调用 /human-review，Claude Code 会自动运行分支分析、测试录制、API diff、数据库 diff、复杂度计算等步骤，最终输出一个 review.html 文件，所有引用都是真实工作树在构建时刻提取的内容，确保 Review 页面与代码状态完全一致。

特点

  • 多维度单页 Report：10+ 专业标签页，一次生成，涵盖代码、API、数据、测试、复杂度、日志、CODEOWNERS
  • 编辑器深链接：每个代码引用直链 VS Code/IDE 对应行，审查者点击即跳转，不需要手动搜索
  • Playwright 行为视频：录制功能演示，配有时间戳字幕，审查者无需自己运行测试
  • 3D Code City 可视化：代码结构在三维城市视图中呈现，类=楼，面积=代码量，高度=复杂度
  • REST 协议 diff：按 breaking/additive/changed/cosmetic 四级自动分类接口变更
  • 零漂移设计：内容从构建时工作树实时提取，不引用 PR 描述，不依赖人工维护
  • MIT 许可证：免费开源，可自由修改和分发

使用方法

安装步骤：

方式一：从 GitHub 下载最新 release 并解压到 Skill 目录

# 下载最新 release（以 vlatest 为准）
curl -L -o human-review.zip https://github.com/victorrentea/human-review/archive/refs/tags/vlatest.zip
unzip human-review.zip
# 移动到 Claude Code skill 目录
mv human-review-xxx ~/.claude/skills/human-review

方式二：直接从 GitHub 克隆

git clone https://github.com/victorrentea/human-review.git ~/.claude/skills/human-review

基本调用：

# 进入包含待 Review 分支的项目目录
cd your-project
# 运行 Human Review Skill
/human-review

Claude Code 自动分析当前分支，生成 review.html，在终端输出文件路径，直接用浏览器打开即可查看。

最小示例：

> /human-review
[Claude Code] 分析分支 feature/payment-refactor...
[Claude Code] 运行测试套件并录制 Playwright 视频...
[Claude Code] 提取 REST API diff...
[Claude Code] 生成复杂度报告...
[Claude Code] 输出: ./human-review-report.html
✅ Review 页面已生成: human-review-report.html

使用场景与人群

适用场景：

  • 大型 Pull Request 的系统性 Review（变更范围大，人工翻 diff 效率低）
  • 跨团队 Code Review（需要同时检查 API 协议、数据模型、测试覆盖等多个维度）
  • AI 辅助开发流程中的 Review 环节（Claude Code 生成代码后，用 Human Review 验证）
  • 复杂重构的安全兜底（复杂度增量标签可帮助 Reviewer 判断重构风险）

目标用户：

  • 软件工程师 / Tech Lead 做 Code Review
  • QA 工程师检查测试覆盖率和行为变更
  • 架构师审查 API 协议变更和数据库 schema 变更
  • 任何使用 Claude Code 进行 AI 辅助开发并希望提升 Review 效率的团队

输入与输出案例

案例一：支付模块重构

输入（在 Claude Code 中执行）：

/human-review

Claude Code 分析分支 feature/payment-refactor，自动：

  • 运行完整测试套件 + Playwright 录制支付流程视频
  • 对比主分支提取 REST API 变更（3 个接口：1 breaking，2 additive）
  • 提取 PostgreSQL schema diff（新增 payment_id 列）
  • 生成复杂度增量报告（2 个 endpoint 认知复杂度上升）
  • 列出所有日志语句变更（检测到 1 处记录了 email 字段，触发 PII 提示）

输出：human-review-report.html，浏览器打开，10 个标签页，审查者逐一过：

  • API 标签：看到 POST /payments 是 breaking change，需要通知前端适配
  • 数据标签：看到新增 payment_id 列，需确认迁移脚本已就绪
  • 复杂度标签：2 个 endpoint 复杂度上升 15%，建议拆分为更小的函数
  • 日志标签：发现 PII 字段被记录，触发合规审查

案例二：修复 Bug 分支

输入：

/human-review

输出：生成 review.html，聚焦以下标签：

  • Review 标签：列出 Agent 修复了 3 个 Bug、拒绝了 1 个无效假设
  • Tests 标签：3 个 Bug 对应 5 个测试，全部通过
  • Complexity 标签：所有 endpoint 复杂度无增量，重构安全
  • Codeowners 标签：2 个需审批人，其中 1 人已批准

审查者无需翻阅任何其他工具，直接在这一页做出判断。

GitHub: https://github.com/victorrentea/human-review

评论区

0 条评论

登录后可评论。

Skill超级捕获手 13 阅读