UStackUStack
AgentBase icon

AgentBase

AgentBase 将 GitHub diff、讨论上下文、作者意图与 AI Q&A 面板整合到一个安静页面,并用 Slack 提醒帮助快速定向。

AgentBase

AgentBase 是什么?

AgentBase 是一个 PR 审查工作区,将多种工具整合到一个页面,用于审查拉取请求。它将 GitHub diff 与 PR 意图和上下文配对,包括作者备注和 Q&A 风格面板(“Ask me anything”),帮助审查者理解变更内容及其原因。

核心目的是通过将审查者通常需要的材料——diff、讨论上下文、工单/意图和代码导航——整合到一个工作流中,减少 PR 审查时的标签页切换,同时添加直接在同一面板中回答后续问题的功能。

主要功能

  • 单页 PR 审查界面(取代多个标签页): 将 diff、讨论/线程上下文、blame/历史视图、工单/原因上下文以及 AI Q&A 面板整合到一个工作区。
  • 基于 Slack 的审查者提醒,包含结构化意图: 发送 Slack 消息,包括 PR 意图、范围、变更的相关代码逻辑以及预计阅读时间,帮助审查者在打开 PR 前快速定位。
  • 与 diff 绑定的 PR“作者备注”: 在相关 diff 行旁边显示作者备注(包括引用的工单链接),捕捉变更的理由。
  • 深度问题上下文加载: 当审查者提问(例如,函数调用位置或变更影响范围)时,AgentBase 加载 PR 和相关代码库审查模式,使答案无需切换分支即可显示。
  • 带脱敏的对话记录处理: 保存前清理秘密(例如,API 密钥/令牌/密码/私钥替换为 [REDACTED]),不存储除所述以外的其他信息。
  • 注重隐私的捕获范围: 仅捕获针对该 PR 与 AI 的对话,以及基本 PR 元数据(仓库、分支、提交),当审查者打开 PR 时。

如何使用 AgentBase

  • Beta 期安装并打开: 站点显示通过 npx useagentbase@latest install 安装。
  • 开始审查 PR: 打开拉取请求时,AgentBase 呈现整合审查页面,包括 diff、作者意图和支持上下文。
  • 在面板中提问后续问题: 使用“Ask me anything”界面(页面标记为 Sprig),请求细节如“函数调用位置”或“此变更还影响什么”,引用 PR 和代码库中可用信息。
  • 以 Slack 提醒作为入口: AgentBase 可在 Slack 中向正确审查者发送消息,包括意图、范围、核心逻辑变更和阅读时间,帮助决定关注重点。

使用场景

  • 边缘/中间件认证重构: 如果 PR 将认证/限流逻辑从每个路由处理器移到边缘中间件,审查者可使用面板验证范围(例如,文件/包)、固定在 diff 上的理由,以及所有调用点是否迁移。
  • 迁移期间审查“影响范围”: 当变更替换函数(例如,用基于标头的读取替换 fetchSession)时,审查者可询问仓库整体影响及是否存在孤立调用点。
  • 快速确定变更内容及原因: 对于包含代码 diff 和意图备注(工单链接、作者理由)的 PR,审查者可阅读解释对应行的“作者备注”,而非跨标签页搜索。
  • 审查期间回答一致性问题: 如果审查者想知道类似重构模式是否之前已上线(例如,先前的 session 中间件重构),可在 Q&A 面板直接请求比较。
  • 团队审查队列分流: 当 PR 堆积在队列中,Slack 提醒提供结构化摘要以高效启动审查,包括预计阅读时间。

常见问题

  • 打开 PR 时 AgentBase 收集什么? 它捕获您与 AI 关于该变更的对话,以及基本 PR 细节(仓库、分支、提交)。它不会监控您编码或阅读笔记本上其他内容。

  • AgentBase 是否存储我 AI 对话中的秘密? 对话记录在保存前经过清理器处理。API 密钥、令牌、密码和私钥会自动替换为 [REDACTED]

  • 我可以询问 diff 视图之外的问题吗? 可以。界面支持后续问题(例如,函数调用位置、影响范围),面板引用从 PR 和代码库加载的相关信息。

  • 通知如何工作? 站点描述发送给正确审查者的 Slack 消息,包括 PR 意图、范围、核心逻辑变更及预计阅读时间。

  • 如何安装 AgentBase? 页面显示使用 npx useagentbase@latest install 安装(Beta 期可用)。

替代方案

  • 使用标准 GitHub UI + 单独笔记的手动 PR 审查: 审查者可以打开 diff、查看对话,并直接使用搜索/blame。这通常需要比整合单页工作区更多的上下文切换。
  • 与 PR 标签并行使用的 AI 代码助手: 可以与 GitHub 并用生成解释或答案的工具,但它们可能无法自动将 diff 上下文、blame 和工单/意图集中到一个审查界面。
  • 按角色路由 PR 并发送 Slack 通知的工作流系统: 一些团队使用自动化通知审查者,但缺少同一位置的“diff + 意图 + Q&A”整合。
  • 代码审查检查清单和模板: 团队可以通过标准化检查清单和 PR 模板减少遗漏上下文;这有助于一致性,但无法像这样提供与 diff 和代码库绑定的 PR 特定 Q&A。