PR Lens

这个 Agent 能做什么，适合哪些场景？

PR Lens 可通过 GitHub App、GitHub Action、CLI 或 coding agent skill 运行，为 pull request 生成架构和数据流图。核心格式是 `@coldtea/pr-lens-schema` 的 JSON graph，由 `@coldtea/pr-lens-renderer` 渲染为自包含的明暗主题 SVG。GitHub App 会在 PR 评论中发布图示，并在后续 push 时更新；CLI 和 Action 则可使用你提供的模型密钥分析 diff。项目还提供 GitLab CI/CD component 和 Bitbucket pipe，支持在相应的合并请求或 pull request 流程中生成图示。它适合希望在代码评审中快速理解跨组件改动的团队；需要自行选择模型、配置流水线和提供密钥的团队应考虑相应部署成本。

PR Lens 读取相对 merge base 的代码 diff，并在分析路径中调用所选模型生成 graph JSON。@coldtea/pr-lens-cli analyze 可执行分析，render 生成每个图示的明暗 SVG，validate 检查 graph 和仓库配置，comment 输出适用于目标代码托管平台的 Markdown，export 可导出系统 map。图示以 lane、card 和连接路径呈现变更涉及的组件与调用；架构图用绿色表示新增、琥珀色表示修改、红色表示删除。数据流图按步骤展示路径，也可查看箭头承载的请求或响应形状。GitHub App、GitHub Action、GitLab component 和 Bitbucket pipe 可将图示与评论集成到各自的评审流程；coding agent skill 可让兼容的本地 coding agent 为代码变更绘图。

1. 评审者在大型 PR 中想先定位受影响的组件和调用路径，再逐文件阅读 diff。
2. 维护单体仓库的工程师需要查看变更跨越哪些 lane、组件及数据流步骤。
3. 使用 coding agent 的开发者想在 PR 创建前为刚完成的改动生成 SVG 图。
4. GitHub 团队希望安装 App，让 PR 评论在每次 push 后更新图示。
5. 使用 GitLab 或 Bitbucket 的团队希望通过 CI/CD component 或 pipe 在评审中发布图示。

如何安装或部署这个 Agent？

本地 CLI 和 coding agent skill 的安装方式如下。仓库要求 Node 20.11 或更高版本及 pnpm 10；GitHub App 用户可从其安装页安装。若通过 Action、GitLab component 或 Bitbucket pipe 部署，需按各自配置文件设置模型密钥及相应评论权限凭据。

npx skills add coldteadotai/pr-lens

pnpm install

如何使用这个 Agent？

首次 CLI 分析需要设置模型提供方对应的 API key。默认提供方是 Gemini；也可选择 OpenAI，或配置兼容 /chat/completions 的服务。以下命令从 origin/main 的 merge base 分析变更并渲染 SVG：

export GEMINI_API_KEY=…
npx @coldtea/pr-lens-cli analyze --base origin/main
npx @coldtea/pr-lens-cli render .pr-lens/graph.json

CLI 也可在分析后运行 validate、comment 和 export。GitHub Action 示例使用 pull_request 触发器；将模型密钥保存为仓库 secret，并授予发布 SVG 和写入 PR 评论的权限：

name: PR Lens

on:
  pull_request:

permissions:
  contents: write
  pull-requests: write

jobs:
  lens:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: coldteadotai/pr-lens/packages/action@v0
        with:
          api-key: ${{ secrets.GEMINI_API_KEY }}

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题