Human Review Skill:让 AI 审核像 Google Docs 协作一样直观
让 AI 代码审核像 Google Docs 协作一样直观——Human Review Skill 深度解析
功能与原则
Human Review 是一个专为 AI Coding Agent 设计的视觉化代码/文档审核工具。它让用户直接在浏览器里编辑 HTML 和 Markdown 文件、留下评论像 Google Docs 那样精准锚定文字,最后一次性把全部修改和反馈发给 AI Agent,Agent 再统一应用到源文件。它的核心原则是:减少来回沟通成本,把「描述改动」变成「直接做改动」。
认可度
截至 2026-08-27,GitHub 星标数为 1,170(创建于 2026-07-27,约 1 个月),本周新增 +389 星,处于 GitHub Trending 上升期。项目目前有 86 个 Fork,25 个 open issues,维护活跃。
链接
GitHub:https://github.com/petergyang/human-review
原作者
作者为 Peter Yang(GitHub @petergyang),是一位专注于 AI 开发者工具的独立创作者,同时运营 Behind The Craft 个人 AI 系统和 YouTube 频道,长期输出 AI 编程实战教程。
介绍
在 Human Review 出现之前,向 AI Agent 反馈文件修改意见是一件非常痛苦的事。当你想改一句话、删一个卡片、调整 CTA 按钮时,你不得不写一长串文字描述:「第三段把 X 改成 Y」「删掉第三个卡片因为和第一个重复」「重写 CTA」——然后祈祷 Agent 全部理解正确。这个过程在审核长文档、落地页或多页面网站时尤为折磨。
Human Review 的思路很简单:不描述改动,直接做改动。用户打开一个 HTML 或 Markdown 文件(或本地运行的网页),可以直接编辑文字、拖拽调整布局、粘贴图片、移除元素,还能在任意位置留下评论。所有修改完成后点「Send」,Agent 一次性收到完整反馈,刷新页面等待下一轮审核。整过程像在 Figma 或 Google Docs 里协作,只是对象是 AI 生成的代码。
技术实现上,Human Review 由 human-review CLI + 本地审查服务器 + Chrome 可视化界面组成,支持 ChatGPT、Claude Code、Codex 等主流 Coding Agent。安装方式极其简单——只需在 Agent 对话里粘贴一行安装命令即可,无需账号、无需云服务、无需 API Key。
特点
- 可视化编辑:直接在浏览器里改文字、调格式、拖拽布局,不用描述「改哪里、怎么改」
- 精准锚定评论:选中任意文字或元素留下评论,像 Google Docs 一样评论会锚定到具体位置
- 批量反馈:所有编辑和评论一次性发给 Agent,减少 Agent 理解偏差
- 零门槛安装:在 Agent 对话里粘贴一行命令即可完成安装,无需手动配置
- 本地运行:所有数据留在本地,不上传到任何云服务,隐私安全
- 支持多页面:按住 Command 点击链接可同时审核多个页面,反馈不丢失
使用方法
安装(在 ChatGPT / Claude Code / Codex 等 Agent 对话里粘贴):
Install the /human-review skill globally from https://github.com/petergyang/human-review
或使用 npx 安装:
npx -y human-review setup --global
使用:
打开本地 HTML 或 Markdown 文件进行审核:
/human-review (your file)
审核运行在 localhost 的页面:
/human-review (localhost URL)
Agent 会启动本地服务器,打开浏览器可视化界面,用户做完所有编辑和评论后点 Send,Agent 收到反馈并更新源文件,刷新页面等待下一轮。
使用场景与人群
适用场景:AI 生成的代码审核、长 Markdown 文档修订、AI 落地页 UX 优化、多页面网站局部调整、AI 写作计划的逐段润色。
目标用户:使用 Claude Code、Codex、Cursor、Copilot 等 AI Coding Agent 的开发者;需要频繁审核 AI 生成内容的產品经理和设计师;以及任何对 AI 生成结果有精细修改需求的用户。
输入与输出案例
案例 1:审核 AI 生成的落地页
- Input:用户在 Claude Code 里执行
/human-review generated-landing.html - Output:浏览器打开该 HTML 文件,用户直接删除了第二个 Hero 区块、重写了 CTA 按钮文字、在第三段加了一条评论「这里数据过时了请更新」,然后点 Send
- Agent 收到:一个包含「删除区块2」「CTA 文字改为 Get Started Free」「第三段数据需更新」的完整修改清单,Agent 应用后刷新页面,用户继续下一轮审核
案例 2:修订 AI 写的 README
- Input:执行
/human-review README.md - Output:浏览器渲染 Markdown,用户直接改了标题措辞、删掉一个重复的安装步骤、在「支持平台」列表里加了一行评论「还支持 Windows 吗?」,点 Send 后 Agent 收到反馈,更新文件,页面刷新
评论区
登录后可评论。