# PR #21747 完整报告

- 仓库：`sgl-project/sglang`
- 标题：Rename rerun-ut to rerun-test
- 合并时间：2026-03-31 17:31
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/21747

---

## 执行摘要
本 PR 将 CI slash 命令从 `/rerun-ut` 重命名为 `/rerun-test`，以更准确地反映其运行所有注册测试（包括端到端测试）的功能。变更涉及文档、工作流文件和代码引用更新，属于命名规范化改进，但需关注权限键变更可能导致的向后兼容性问题。

## 功能与动机
重命名动机源于命令功能的误读：原名称 `/rerun-ut` 暗示仅运行单元测试，但实际上它能运行任何注册测试（如端到端测试）。根据 PR body，目的是 "for clarity, since the command runs any registered test (including e2e tests), not just unit tests."，通过更名提升用户体验和文档准确性。

## 实现拆解
实现按模块拆解如下：
- **文档模块**：更新 `.claude/skills/ci-workflow-guide/SKILL.md` 中的命令描述，确保用户指南同步。
- **CI 工作流模块**：重命名文件 `.github/workflows/rerun-ut.yml` 为 `rerun-test.yml`，并调整 `run-name` 和输入描述；同时更新 `.github/workflows/slash-command-handler.yml` 中的命令触发器逻辑。
- **命令处理模块**：在 `scripts/ci/utils/slash_command_handler.py` 中，关键改动包括：
 - 函数名从 `handle_rerun_ut` 改为 `handle_rerun_test`。
 - 日志消息和字符串引用更新，例如将 `"rerun-ut"` 替换为 `"rerun-test"`。
 - 权限键从 `can_rerun_ut` 重命名为 `can_rerun_test`，但未同步更新权限文件。

## 评论区精华
Review 中仅有一条评论，来自 gemini-code-assist[bot]，聚焦于权限键变更的风险：
> "Renaming the permission key from `can_rerun_ut` to `can_rerun_test` is a breaking change for users defined in `.github/CI_PERMISSIONS.json`... consider checking both the new and old keys."

该评论强调了安全访问控制的重要性，建议实现向后兼容逻辑，但 PR 合并时未显示该建议被采纳，留下潜在隐患。

## 风险与影响
- **风险**：权限键重命名可能导致现有授权用户（如定义在 `.github/CI_PERMISSIONS.json` 中）无法使用命令，构成安全风险；重命名还可能影响外部脚本依赖，但变更限于内部，回归风险低。
- **影响**：用户需适应新命令名称，但功能不变；系统 CI 流程内部引用更新，无性能或安全影响；团队需验证权限文件是否同步，否则可能中断协作。

## 关联脉络
与历史 PR #21753（"[CI] Fix rerun-test suite detection to skip commented registrations"）直接相关，后者修改了同一文件 `scripts/ci/utils/slash_command_handler.py` 并针对 `rerun-test` 命令进行修复。这表明重命名后可能有后续调整需求，整体 CI 测试工具链在持续演进中。