# PR #24979 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[Doc] Add rerun-test slash command usage
- 合并时间：2026-05-11 21:30
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/24979

---

## 执行摘要

该 PR 在开发者贡献指南中添加了 `/rerun-test` 斜杠命令的使用文档，允许用户直接指定测试规格来重跑特定测试。变更仅涉及一个文档文件，无代码逻辑修改，风险极低。

## 功能与动机

当前 CI 流程中 `/rerun-test` 命令已经实现，但缺乏文档说明。PR 目的就是补全这一缺失，让贡献者了解如何使用该命令通过评论触发特定测试的重跑。

## 实现拆解

1. 在 `docs_new/docs/developer_guide/contribution_guide.mdx` 文件的斜杠命令列表末尾新增一行关于 `/rerun-test` 的说明。
2. 定义命令格式：`/rerun-test <test-spec> [<test-spec> ...]`，其中 `<test-spec>` 使用 `file::TestClass.method` 的格式，`TestClass` 和方法部分可选。
3. 说明命令行为：根据注册的 runner-label 分组并触发对应的重跑工作流。
4. 提供多个示例和权限说明。

## 评论区精华

- **gemini-code-assist[bot] 指出格式描述问题**：文档中称为“pytest-style”但使用了点号分隔类和方法，而标准 pytest 使用 `::` 分隔所有层级。建议直接描述格式以避免混淆。该评论未获回应。

## 风险与影响

- **风险**：仅文档变更，无代码逻辑修改，无技术风险。但文档中关于 test-spec 格式的描述存在歧义，可能让用户对实际可用的分隔符产生困惑。
- **影响**：影响范围小，仅对需要重跑特定测试的贡献者有用。

## 关联脉络

无关联的 Issue 或历史 PR。