1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | pr-lens |
| 作者/维护者 | coldteadotai（Coldtea） |
| 来源链接 | https://github.com/coldteadotai/pr-lens |
| 许可证 | MIT（GitHub API） |
| GitHub Stars | 940（GitHub API） |
| Forks | 34（GitHub API） |
| 最新版本 | v0.5.0（2026-09-08 发布，GitHub Releases） |
| 安装方式 | npx skills add coldteadotai/pr-lens（Agent Skill）；另提供 GitHub App / GitHub Action / CLI 三种非 Agent 安装方式 |
2. 功能介绍与亮点
PR Lens 教会编码 Agent 把一次代码变更画成动态的架构图与数据流图，并把图直接放进 Pull Request 里。核心流程是：Agent 读取 diff（git diff --find-renames），把变更结构写成一份 JSON 文档（车道、节点、边、有序流程），用官方 CLI 校验并渲染成主题化的动画 SVG，最后通过 gh pr create/edit/comment --attach 把图挂到 PR 描述或评论里。
亮点：
- 渲染完全本地化：
validate与render两步不发起任何网络请求，第三方用户在 issue 中亲自核实过“客户端部分完全离线可用”这一说法（见第 8 章）。 - 有明确的可视化方法论，不是随手画图：区分架构视图（系统上下文/容器/组件的 C4 式决策树）与数据流视图，并规定“walkthrough”讲解稿的写作规则（每步一个变化点、标题与正文分工明确），目的是让审阅者不用先读完 diff 就能看懂改动。
- 纠错走配置覆盖而非改生成结果：图画错了不是手改生成文件，而是写
.github/pr-lens.yml做重命名/排除/车道调整，下次重新推理时自动生效。 - 维护活跃：最新版本发布于 2026-09-08，仓库当前有 7 个开放 issue，处于持续迭代状态。
3. 适用场景
所属分类：工程效率与代码质量。
适合需要频繁开 Pull Request、且希望审阅者（人类或另一个 Agent）在读 diff 之前先建立整体认知的团队，尤其是变更本身逻辑分散在多个文件、审阅者难以从代码块拼出全貌的场景，例如把同步发送改造成批处理发送、给一条数据管线加一段新的中间层。也适合“AI 生成 PR 越来越多、人类审阅精力跟不上”的团队——用一张图承担了原本需要读完整个 diff 才能建立的心智模型。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | README 明确列出，SKILL.md 遵循标准 Agent Skills 格式 |
| Codex | ✅ 原生支持 | README 明确列出 |
| OpenClaw | ❓ 未验证 | README 兼容列表中出现的是 “OpenCode”，与 “OpenClaw” 并非同一产品，未见对 OpenClaw 的直接说明 |
| Hermes Agent | ❓ 未验证 | README 未提及 |
5. 推荐理由
它把“看懂一次代码改动”从一件要读完整份 diff 才能完成的事，变成了一张图加一段讲解稿就能完成的事，且这张图的生成完全在本地进行，不依赖任何托管账号或 API key。对审阅精力有限、又要应对越来越多 AI 生成改动的团队，这是一种低成本的认知负担削减。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 940 stars/34 forks，处于 200–1k 区间；仓库创建仅 20 天但已同时提供 GitHub App、Action、CLI 三种独立分发渠道，多渠道并行发展 |
| 可用性 | 9 | 单条命令 npx skills add 即可安装；核心渲染流程无需任何账号或 API key；文档含完整字段说明与示例文档；最近一次发布为一天前 |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
① Shell 命令执行——通过 npx @coldtea/pr-lens-cli@latest 执行校验与渲染，范围限定在读取 diff、写入 .pr-lens/ 目录；可选步骤会调用 gh 完成 PR 挂图。② 联网外发——核心 validate/render 完全离线；仅当用户主动执行“canvas push”这一可选步骤时才会把图上传到作者自建的 prlens.dev，SKILL.md 对“查看链接可公开分享、编辑链接不可外泄”做了明确说明。③ 凭据——仅在用户选用可选的 analyze（用大模型自动生成图内容）功能时才需要用户自备的模型 API key，非核心路径。④ 未见可疑指令或夹带的品牌推广内容。⑤ 作者信誉——独立小团队产品，未发现刷星或身份造假迹象，GitHub App 已在市场公开上架。⑥ License 明确（MIT）。⑦ 最近一次发布为 2026-09-08，维护活跃。整体扣分点是渲染 CLI 通过 @latest 拉取而非锁定版本号，存在供应链层面的版本不可控风险。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 pr-lens 的差异 |
|---|---|---|
| xpepper/pr-review-agent-skill | 自动化 GitHub PR 代码评审工作流的技能合集 | 产出的是评审意见/问题清单，回答“这段代码有没有问题”；pr-lens 明确声明自己“不是评审机器人”，只负责让改动被看懂，两者解决的是评审流程里不同的环节 |
| SpillwaveSolutions/pr-reviewer-skill | 按行业标准（安全/测试/可维护性）产出结构化评审文件并发起审批流程 | 同样是“评审”取向的工具，侧重生成文字评审结论；pr-lens 侧重可视化理解，不产出评审判断 |
pr-lens 与同类项目的核心差异在于它刻意不做“评判”，只做“讲清楚”——这让它可以和上面两类真正做评审判断的工具搭配使用，而不是互相替代。
8. 用户评价
在该仓库的 GitHub Issues 中，第三方用户 ubuntudroid 在 2026-09 提交的 issue #16 里明确核实过其离线特性：“客户端部分（cli、renderer、schema、action 与 agent-skill）都在 MIT 协议下、完全开源，validate 与 render 生成 SVG、manifest 和 drawn.graph.json 全程不发起任何网络请求，README 里’开源/无需 API key/本地运行/MIT 协议’的说法对这部分是准确的”;同时该 issue 也指出画布分享功能（canvas）目前只能连接作者自建的托管服务，无法自托管替代实例。该反馈来自一个有独立提交历史的第三方 GitHub 账号，属实际验证而非转述。
9. 其他补充
暂无。
10. 安装使用方式
- Agent Skill（推荐）：在项目中运行
npx skills add coldteadotai/pr-lens，随后对 Agent 说“用 PR Lens 把这次改动画成图并附到 PR 上”即可触发。 - GitHub App：在 https://github.com/apps/coldtea-pr-lens 为需要审阅的仓库安装，每个 PR 会收到一条自动更新的图示评论，无需任何模型 key。
- GitHub Action：在
.github/workflows/中配置，用自己的 CI 与模型 key 运行。 - CLI：直接使用
npx @coldtea/pr-lens-cli手动执行 validate/render/canvas push 等子命令。 - 注意事项：使用“canvas push”功能会把图数据上传到作者的托管服务，编辑链接具备写权限，不应公开粘贴；
--attach依赖 GitHub CLI 2.99 及以上版本。
11. 注意事项
- 渲染 CLI 通过
npx ...@latest拉取最新版本，未锁定具体版本号，团队若要求可复现的构建应自行锁定版本。 - 与 OpenClaw、Hermes Agent 的兼容性未经验证，README 只明确列出了 Claude Code、Codex、Gemini CLI、Cursor、OpenCode 与 Copilot。
- 该技能明确不产出评审结论（无 bug/风险字段），需要评审判断仍需搭配其他工具或人工阅读。