用 PR Lens 把拉取请求变成动画图解

一个四百行的拉取请求之所以难评审，是因为 diff 展示的是文本变化，而不是系统如何运转。PR Lens 是一个 2k 星的 MIT 项目，它直接把变化画出来：动画化的架构图和数据流图，作为评论贴在拉取请求内部，让你在读代码之前先看懂它。

为什么这个 Skill 重要

渲染器是完全自研的，README 对比较说得毫不含糊："Not Mermaid, better."（不是 Mermaid，而且更好。）图里把代码的新增、删除和修改表示成卡片和路径——支持缩放、交互画布和变更走查——同时仍能扩展到非常大的系统。README 的名人堂里收录了 react/react#13968，也就是 React Hooks 背后的那个拉取请求：36 个文件，+5,868/−130，画成五条泳道。

安装

两条路径解决不同的问题。GitHub App 是零配置的那条：在任意仓库上从 github.com/apps/coldtea-pr-lens 安装，打开一个拉取请求，图就会出现为一条评论，并在每次推送时更新——不需要模型密钥。PR Lens 也能跑在 GitLab（CI/CD component）和 Bitbucket（pipe）上。

Agent skill 是第二条路径，面向拉取请求还不存在的阶段：

npx skills add coldteadotai/pr-lens

实战：在开拉取请求之前先把改动画出来

装好 skill 之后，对 Agent 说：

用 PR Lens 把你刚才的改动画成图，附到拉取请求描述里。

Agent 读取 diff 并写出图文件，然后反复运行 npx @coldtea/pr-lens-cli validate，直到文件通过全部检查。只有在这之后它才渲染图，并用 gh pr create --attach 附上去，这样拉取请求一打开图就已经在了。如果图里有名字写错了，skill 会教 Agent 去改 .github/pr-lens.yml，而不是手改它生成的文件。

你还可以让 Agent 接到实时画布上工作：提问、缩放到图的任意部分，或者拖选几张卡片追问。README 列出的 Agent 选项包括 Claude Code、Codex、Gemini CLI、Cursor、OpenCode 和 Copilot，每张图都有亮色和暗色两个版本。

想在自家 CI 里产出同样评论的团队可以改用 GitHub Action：.github/workflows/pr-lens.yml，运行 coldteadotai/pr-lens/packages/action@v0，模型密钥存成仓库 secret。它兼容任何说 /chat/completions 协议的服务——README 点名了 OpenAI 和 Gemini。

技巧

• 先在一个繁忙的仓库上装 GitHub App——每个拉取请求一条评论、随每次推送保持最新，是检验这种格式是否适合你团队的最低成本方式。
• Agent skill 不只用于评审，也可以用来理解代码库：让它给你即将重构的子系统画一张图。
• 单体仓库级别的视图和单卡片变更用的是同一套视觉语言——泳道、卡片、标记变化的颜色、可以顺着看的路径。
• README 里有单独的章节讲如何自托管画布。

何时不用这个 Skill

这些图是用来理解的，不是用来批准的：该读的代码还是要读。另外 App 路径替你画图，而 Action 路径需要你自己的模型密钥——如果两条都不合适，你的 Agent 仍然可以通过 skill 在本地画图。

查看 排行榜 了解更多 skill。