mps-review 用于在当前分支上运行代码审查,并将审查结果发布到 reviews 分支,使 review-gate CI 检查能够通过。
用途与流程
第一步确定 PR 编号:若用户以参数提供则直接使用;否则从当前分支名推导(如 feature/PR-21-description),无法确定时向用户询问。
第二步执行审查:直接对当前分支相对 main 的改动进行审查,不使用 gh 或 /review 技能。先用 git log --oneline main..HEAD 确定范围:提交数不超过 10 个时审查完整 diff(git diff main..HEAD);超过 10 个时询问用户或默认审查最近 5 个提交(git diff HEAD~5..HEAD);用户指定提交范围时按指定范围。审查覆盖代码正确性与潜在缺陷、项目约定遵循、性能影响、测试覆盖和安全考虑。
测试覆盖期望:若 diff 新增了 Test/ 和 +test/ 目录之外的 .m 公共函数,需检查是否附带对应测试;若无新增或修改的测试文件,则在审查中列出每个缺少测试覆盖的新公共函数,并要求作者在 Review Response 中说明原因(可接受理由包括已被现有测试覆盖、测试 PR 另行计划、内部辅助函数无法直接测试)。这不是自动拒绝,而是必需说明;作者回应后 review-gate 即可通过。
自动拒绝规则:若新增 MATLAB 代码(.m 文件)中包含 Java 调用(如 java.util.、java.lang.、javaObject、javaMethod 或任何 java. 引用),结论必须为 Reject,需标出每处出现并明确说明在移除所有 Java 用法前该 PR 不能获批。
第三步写审查文件:创建 reviews 目录,文件为 reviews/PR-<N>.md。首次审查时写入日期标题的审查内容和 ## Review Response 占位段;再次审查时把新审查与新的 Review Response 占位段插入文件顶部,其后加 --- 分隔线,并保留全部历史内容。CI 的 review-gate 只检查最顶部的 ## Review Response 段。
第四步推送到 reviews 分支:在 CIFS/SMB 网络共享上 git 的原子引用重命名会失败,因此不应使用 git worktree 或 git commit,而应使用 git fetch、git rev-parse、git hash-object、git ls-tree、git mktree、git commit-tree 和 git push 等底层命令构建提交并直接推送;命令末尾的 grep -v "update_ref failed" 用于忽略本地跟踪引用更新失败的无害 CIFS 错误。
第五步告知用户:审查已发布为 reviews/PR-<N>.md;再次审查时旧内容保存在 --- 分隔线之下;用户需在最顶部 ## Review Response 下填写实质性文字,仅占位注释或空白不会通过检查;可在本地编辑后以同样方式推送,或由助手协助。
适用场景与限制
适用于采用 reviews 分支与 review-gate CI 的 MATLAB 仓库,尤其是位于 CIFS/SMB 共享上、常规 git 提交方式不可用的环境。限制与错误处理包括:远端不存在 reviews 分支时需先一次性创建;推送报 update_ref failed 但远端已接受时视为成功;非快进拒绝时需重新 fetch origin/reviews 并在新 HEAD 上重建提交;权限不足时提示用户手动推送;diff 为空时告知无改动可审查。该技能不使用 gh 和 /review,且审查范围默认受提交数规则约束。