SuperAPI AI 工具集

alan-review-pr

编程与开发

查看项目

更新于 11-13 06:18

技能介绍

用途

该技能用于对指定的 GitHub 拉取请求进行自动化代码评审,所有 GitHub 操作都通过 Alan MCP 服务器提供的 mcp__alan__github_* 工具完成,无需额外配置 GitHub 令牌、SSH 密钥或 gh CLI 认证。

主要能力

  • 解析输入:支持 PR 编号(如 42、#42)、PR URL 或 owner/repo#42 形式;若只给编号,则通过 git remote get-url origin 解析 owner 与 repo。
  • 获取上下文:PR 详情、统一 diff、变更文件列表、已有评审、已有评论,以及 head 分支或 SHA 的 CI 检查状态(失败时给出 html_url 供查看日志)。
  • 分析问题:只针对本 PR 引入的问题,按优先级检查安全性、正确性、性能、错误处理、可维护性与测试覆盖。
  • 置信度过滤:只保留能定位到具体文件与行、能描述具体触发场景且置信度不低于 80% 的问题;跳过 linter 可捕捉的问题、推测性风险、风格偏好与既有问题。
  • 提交评审:每个发现单独发一条行内评论,并附汇总评论;存在 🔴 阻断性问题时以 REQUEST_CHANGES 提交,否则以 COMMENT 提交;无发现时提交通过评审。

使用方式

调用前需确认工具列表中可见 mcp__alan__github_* 工具,否则应停止并提示检查沙箱 MCP 配置。工具的通用参数为 owner(字符串)、repo(字符串)、prNumber(整数)。执行流程依次为:解析输入、获取 PR 元数据、diff、变更文件、已有评审、已有评论、CI 状态,必要时读取完整源文件补充上下文,分析后调用 mcp__alan__github_create_pr_review 发布行内评论与汇总。

行内评论包含隐藏元数据注释、严重级别图标(🔴 阻断、🟡 重要、🔵 次要)、简短标题、详细描述、供 AI 代理执行的修复提示(details 折叠块)以及“Open in Alan”徽章。汇总评论包含问题数量统计表与按严重级别分组的全部发现列表,同样带徽章;徽章链接到当前 Alan 会话 URL,未提供时回退为 https://app.tryalan.ai。

适用场景

适用于开发者或自动化流程需要对 GitHub PR 做结构化、可追踪的代码评审,并将结果直接以评论和评审形式回写到 PR 的场景。

限制

资料明确要求不得使用 curl/wget 调用 GitHub API、不得使用 gh CLI、不得扫描令牌或配置认证、不得安装用于 GitHub 访问的包或 CLI;MCP 工具调用失败时需向用户报告错误,不得回退到 CLI 方案。除 git remote get-url origin 外,GitHub 相关操作均应使用 MCP 工具。资料未提供收费、价格、平台支持范围等信息;官方页面文本暂未提供。