Aido：面向 AI 生成 PR 的 GitHub 审查助手

随着 Copilot、Claude Code、Cursor 等 AI 编码代理越来越多地直接提交 pull request，开发者需要在不理解上下文的情况下审查 AI 生成的代码。Aido 是一款 GitHub Action 形态的审查辅助工具，定位为「AI 写 PR 时的同伴」，帮助人类保持对代码变更的理解与判断。

核心功能

Aido 围绕 PR 审查全生命周期提供六类命令：review（多角色代码审查）、summarize（高层摘要）、explain（开发者向逐步解释）、docs（生成或补充文档）、test（结构化测试计划）和 triage（Issue 分类与标签建议）。

• 在任意 PR 或 Issue 下评论 aido review、aido summarize 等命令即可触发对应能力。
• 支持「按需调用」与「自动运行」两种模式：后者会在检测到 AI 作者（Copilot、Claude Code、Cursor 等）开 PR 时自动触发 explain 与 summarize。
• 仅在 PR open / reopen / ready_for_review 时触发，不会对每次 commit 重复运行。

多模型与安全设计

Aido 采用 BYOK（自带密钥）模式，默认使用 Gemini，同时支持 ChatGPT 和 Claude，用户可在配置文件中为不同命令指定不同模型。

• 三家提供商的 API Key 分别以 Secret 形式注入 GitHub Actions，不经第三方数据处理。
• 自动运行通过 pull_request 事件触发，而非 pull_request_target，因此对 fork PR 仅使用只读 token，无法访问仓库 Secrets，安全性更好。
• 默认排除 github-actions[bot] 与 dependabot[bot]，避免过度触发或因权限不足导致失败。

安装与定制

提供两种安装方式：

• 远程安装（推荐）：将单个工作流文件复制到 .github/workflows/aido.yml，升级只需修改固定版本标签。
• 拷贝安装：将工作流与脚本完整提交到仓库，获得完全控制权。

每条命令均支持通过 JSON 配置文件自定义 prompt、角色（persona）、语气与所用模型，无需修改脚本即可调整默认行为。也可作为 composite action 嵌入自有工作流，按自定义触发条件运行。

适用边界

Aido 本质上是对现有 LLM 能力的工程化封装，并不提供新的基础模型或训练方法。它的价值在于将多模型 PR 审查统一收敛到 GitHub 原生工作流中，降低团队接入门槛。对于已经在使用 AI 编码代理并希望系统化沉淀审查流程的小到中型团队，这是一个轻量级选项。