// PR 审查、测试、修复、合并全流程。从创建集成分支到最终通过 GitHub Squash Merge 合并。使用场景：审查 PR 代码、运行 GUT 测试、修复问题、合并提交。
| name | pr-review-merge |
| description | PR 审查、测试、修复、合并全流程。从创建集成分支到最终通过 GitHub Squash Merge 合并。使用场景：审查 PR 代码、运行 GUT 测试、修复问题、合并提交。 |
审查从 GitHub 获取的 PR 分支，确认代码质量后通过 GitHub Squash Merge 合并，PR 自动关闭。
git fetch origin 'refs/pull/*/head:refs/remotes/origin/pr/*' 获取 PR refsaddons/gut/）gh 或网页获取）git checkout main
git checkout -b integration/pr-review
如果分支已存在：
git checkout main
git branch -D integration/pr-review
git checkout -b integration/pr-review
git merge origin/pr/<number> --no-edit
解决冲突后：
git add <resolved-files>
git commit --no-edit
对每个变更文件逐项检查：
3a. 功能完整性
3b. 测试覆盖 对照变更文件逐项检查测试覆盖，使用矩阵记录：
| 变更文件 | 变更内容 | 对应测试文件 | 覆盖状态 |
|---|---|---|---|
xxx.gd | 具体变更 | test_xxx.gd | ✅/❌ |
检查要点：
get_script_property_list() 断言3c. 代码规范
检查清单：
@export 变量有 setter 时调用 notify_property_list_changed()_debounce_save()（持久化）extends "res://addons/gut/test.gd"（GUT 测试）3d. 多语言适配（UI 变更必检） 涉及 UI 新增/修改文本时：
.text 通过 _tr(key) 赋值，而非硬编码字符串mcp_panel.csv 新增了对应的 key 行_refresh_translations() 对新增控件做了翻译刷新3e. 重复代码检查
& "f:/Godot/Godot_v4.6.1-stable_win64.exe" --headless --path "F:/gitProjects/Godot-MCP-Native" -s addons/gut/gut_cmdln.gd -gdir=res://test/unit/ -ginclude_subdirs -gexit
验收标准：
记录问题分级：
_debounce_save()、硬编码字符串、缺少翻译 key 等——审查者直接推送到 PR head 分支修复# 1. 基于 PR head 分支创建修复分支
git checkout -b fix/pr<number>-review-fixes origin/pr/<number>
# 2. 修改代码、运行测试验证
# 3. 推送到 PR 的 head 分支（需 collaborator 权限）
git push origin fix/pr<number>-review-fixes:<PR_head_branch>
# 4. 回到集成分支重新合并验证
git checkout integration/pr-review
git merge origin/pr/<number>
# 通过 GitHub 提交 Review（Request Changes）
gh pr review <number> --request-changes --body "审查意见..."
# PR 作者修复并 push 后，重新从 Step 2 开始
创建审查文档到 docs/debugging/：
docs/debugging/pr<number>-<feature>-review-<date>.md
文档模板：
# PR #N <标题> 审查报告
**日期：** <yyyy-mm-dd>
**审查分支：** integration/pr-review
## 1. GUT 测试结果
| 指标 | 数值 |
## 2. 已修复的问题
### 问题 N：<描述> ✅
**文件：** 路径:行号
**修复：** 说明
## 3. 已记录的问题
### 问题 N：<描述> 🔶
## 4. 测试覆盖率矩阵
| 变更文件 | 测试覆盖 | 状态 |
## 5. 审查结论
推荐方式：GitHub Squash Merge，确保 PR 自动关闭并有合并记录。
# 方式一：gh CLI（推荐）
gh pr merge <number> --squash --subject "<type>: <中文标题>"
# 方式二：GitHub 网页
# 在 PR 页面点击 "Squash and merge"
优点：
备选：本地 Squash（仅限无 GitHub 权限时）
git checkout main
git pull origin main
git merge --squash integration/pr-review
git commit
git push origin main
# 注意：此方式不会关闭 GitHub PR，需手动 Close
# 重新运行全量 GUT 测试确认 0 failures
# 清理本地分支
git branch -D integration/pr-review
git branch -D fix/pr<number>-review-fixes # 如有
提交信息规范：
feat/fix/refactor: <概括>示例：
feat: 新增 Vibe Coding 免打扰模式
新增功能：
- 新增 XXX 策略类
- N 个工具入口添加策略检查
- 插件导出新变量
配套修改：
- 文档更新
- 新增 GUT 测试 N 个
- 修复 XX 持久化问题
| 操作 | 命令 |
|---|---|
| 获取 PR refs | git fetch origin 'refs/pull/*/head:refs/remotes/origin/pr/*' |
| 查看 PR diff stat | git diff --stat origin/main...origin/pr/<N> |
| 查看 PR unique commits | git log origin/main..origin/pr/<N> --oneline --no-merges |
| 创建集成分支 | git checkout -b integration/pr-review origin/main |
| 合并 PR 到集成分支 | git merge origin/pr/<N> |
| 运行 GUT 测试 | & "f:/Godot/Godot_v4.6.1-stable_win64.exe" --headless --path "F:/gitProjects/Godot-MCP-Native" -s addons/gut/gut_cmdln.gd -gdir=res://test/unit/ -ginclude_subdirs -gexit |
| GitHub Squash Merge | gh pr merge <N> --squash --subject "<type>: <标题>" |
| Request Changes | gh pr review <N> --request-changes --body "意见..." |
| Approve PR | gh pr review <N> --approve --body "审查通过" |
| 推送修复到 PR 分支 | git push origin fix/pr<N>-review-fixes:<PR_head_branch> |
| 清理集成分支 | git branch -D integration/pr-review |
| 变更文件 | 变更内容 | 对应测试 | 状态 |
|---|---|---|---|
file1.gd | 新增 X 功能 | test_file1.gd — test_X | ✅ |
file2.gd | 修改 Y 逻辑 | test_file2.gd — test_Y | ✅ |
file3.gd | UI 变更 | 无（UI 手动测试） | ⚠️ |