用途:结合实际代码分析与终端冒烟测试来审查 PR,适用于检查代码改动、运行 CLI 测试等场景。
主要能力与流程:
- 获取 PR 信息:使用 gh pr list、gh pr view <number>、gh pr diff <number> 查看列表、详情与差异。
- 代码审查:从正确性(逻辑与边界情况)、代码风格(是否符合现有约定)、性能、测试覆盖、安全风险等维度分析。输出分级:🔴 Critical 必须修复、🟡 Suggestion 建议改进、🟢 Nice to have 可选优化。
- 终端冒烟测试(建议每个 PR 都执行):先 gh pr checkout <number> 并 npm run build;用终端截图验证 CLI 能正常启动并响应输入,UI 改动可提供直观证据,也可把截图附到 PR 评论。场景选择:任意 PR 默认用 smoke test(发送 hi 验证启动与响应);斜杠命令改动跑对应命令场景(如 /about、/context);Ink 组件/布局改动跑多场景加全流程长截图;大型重构或依赖升级运行 scenarios/all.ts 全量回归。运行方式:将场景配置写入 integration-tests/terminal-capture/scenarios/,单个场景用 npx tsx integration-tests/terminal-capture/run.ts integration-tests/terminal-capture/scenarios/<scenario>.ts,输出在 screenshots/ 目录。最小冒烟示例可复用 about.ts:npx tsx integration-tests/terminal-capture/run.ts integration-tests/terminal-capture/scenarios/about.ts。
- 上传截图:用 Playwright MCP 浏览器打开 PR 页面,在评论框输入标题,点击添加文件按钮,通过 browser_file_upload 上传 PNG,等待 GitHub 处理(约 2-3 秒)后点击 Comment 提交。前提是 Playwright MCP 需配置 --user-data-dir 以保持 GitHub 登录,首次需手动登录。
- 提交审查:用 gh pr review <number> --comment --body "review content"。
限制:资料未提供安装方式、收费、平台支持、审查语言或效果保证等信息;使用前需具备 gh 命令、Node 环境及项目构建脚本,截图上传依赖已登录的 Playwright MCP 会话。