用途
该技能用于使用 Alan 的 GitHub MCP 工具审查 GitHub 拉取请求(Pull Request)。用户提供 PR 编号、PR URL 或 owner/repo#编号 形式的引用后,技能会拉取相关信息并给出结构化评审结果。
主要能力
技能通过一组已存在于工具列表中的 MCP 工具完成操作,工具名称以 mcp__alan__github_ 为前缀,可执行的操作包括:获取 PR 详情、获取 PR 统一 diff、列出 PR 评论、列出 PR 评审、列出变更文件及其增删行数、获取 issue 详情、获取某 ref 的 CI 检查状态、添加评论、提交评审(APPROVE/REQUEST_CHANGES/COMMENT)、添加标签、合并 PR、关闭 issue/PR、请求评审人。
认证由 MCP 服务器自动处理,资料明确说明无需 GitHub Token、gh CLI 认证、SSH 密钥、.netrc 文件、环境变量或任何凭据,工具零配置即可使用。资料禁止使用 curl/wget 访问 api.github.com、使用 gh CLI 命令、扫描 token/secret、读取 ~/.netrc 或 git credential、执行 ssh -T 等认证方式,也禁止安装用于 GitHub 访问的包或 CLI。若 MCP 工具调用失败,应向用户报告错误,不得回退到 CLI 方案。
使用方式
开始前需确认工具列表中可见 mcp__alan__github_* 工具;若不可用,应停止并提示用户检查沙箱 MCP 配置。GitHub PR 工具需要 owner(字符串)、repo(字符串)、prNumber(整数)三个参数,例如调用 mcp__alan__github_get_pull_request 并传入 {"owner": "supatest-ai", "repo": "alan", "prNumber": 42}。
若用户只提供 PR 编号,技能会运行 git remote get-url origin 获取远程 URL 并解析 owner 与 repo;资料强调这是唯一应为 GitHub 操作运行的 git CLI 命令,其余全部使用 MCP 工具。
工作流依次为:解析 owner/repo/prNumber;获取 PR 元数据(标题、描述、状态、标签、分支);获取 diff;列出变更文件;获取已有评审;获取已有评论以了解讨论上下文;检查 CI 状态,若检查失败则附上 html_url 以便用户查看完整日志(该工具不返回日志输出);对复杂变更使用 Read 工具读取完整源文件以获得上下文;进行分析;最后提交评审。
分析仅针对本次 PR 引入的问题,不包含已存在的问题。每条发现需确定:严重级别、文件路径、起止行号、标题、描述,以及可供 AI 代理执行的具体修复提示。
评审维度按优先级排序为:安全(注入、认证绕过、代码中的密钥、输入校验)、正确性(逻辑错误、空值处理、异步问题、竞态条件)、性能(N+1 查询、无界操作、内存问题)、错误处理(静默失败、空 catch 块、被吞掉的错误)、可维护性(超过 30 行的函数、深层嵌套、魔法数字)、测试覆盖(正常路径是否测试、边界情况、断言是否有意义)。
置信度过滤要求:只纳入能指出确切文件与行号、能描述会导致真实问题的具体场景、且置信度不低于 80% 的发现;跳过 linter 可捕获的问题、推测性风险、风格偏好和已存在的问题。
输出格式
每条发现作为独立行内评论发布,格式包含一个 alan-review-comment HTML 注释(含 id、file_path、start_line、end_line、side 字段)、严重级别图标与短标题、详细描述、可折叠的 “Prompt for agents” 代码块,以及链接到 Alan 会话的徽章。严重级别图标为:🔴 Blocking(关键 bug、安全、数据丢失,合并前必须修复)、🟡 Important(真实 bug/风险,合并前应修复)、🔵 Nit(轻微质量问题,容易修则修)。
评审正文为汇总评论,包含 “Alan Review found {N} potential issues”、按严重级别统计的表格、可折叠的全部发现列表,以及 Alan 徽章和反馈提示。徽章链接指向当前 Alan 会话 URL,若未提供会话 URL 则回退到 https://app.tryalan.ai。
提交评审时调用 mcp__alan__github_create_pr_review,传入 owner、repo、prNumber、汇总正文、event(存在 🔴 阻塞问题时为 REQUEST_CHANGES,否则为 COMMENT),以及行内评论数组(每项含 path、line、body)。资料强调:始终发布行内评论而非合并成一条大评论;每条发现都包含 “Prompt for agents” 部分;每条评论与汇总都包含 “Open in Alan” 徽章;每个徽章都要替换为实际会话 URL;若零发现,则发布一条带有干净汇总的批准评审。
适用场景
适用于在具备 Alan MCP 工具的沙箱环境中对 GitHub PR 进行结构化代码审查,覆盖安全、正确性、性能、错误处理、可维护性与测试覆盖等维度。
限制
该技能依赖 mcp__alan__github_* 工具是否存在,工具缺失时必须停止。除 git remote get-url origin 外不得使用其他 git CLI 命令,也不得使用任何 CLI 或凭据方案进行 GitHub 访问。CI 状态工具仅返回检查状态与 html_url,不返回日志输出。关于收费、价格、平台支持范围等更多信息,资料未提供。