# PR #30608 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[misc] Add unit test admission criteria to agent rules
- 合并时间：2026-07-09 14:41
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/30608

---

# 执行摘要

- 一句话：新增单元测试准入规则至 agent 配置
- 推荐动作：值得精读该规则文档，并建议在团队内推广使用，尤其适合作为新成员编写测试的指引。可与 `write-sglang-test` 技能文档配合使用。

# 功能与动机

PR body 指出需要定义清晰的单元测试准入标准，引导开发者只编写能对实际 diff 产生守卫价值的测试，避免低质量或冗余的测试浪费维护精力。

# 实现拆解

1. 在 `.claude/rules/unit-test-admission.md` 中定义路径范围：`test/**/*.py`，仅当修改测试文件时注入该规则。
2. 明确三类可准入测试：bug 回归（要求能在修复前代码上复现）、推导属性（保护边界 / 协议语义等推导结论）、关键路径记账（如注册表完整性、序列化兼容性）。
3. 明确拒绝三类测试：快乐路径赘述、镜像测试（实现逻辑重述）、概率性压力测试（无法确定性能复现故障）。
4. 强调强测试优于多测试，每个用例应守卫独立的故障模式。

关键文件：
- `.claude/rules/unit-test-admission.md`（模块 开发规范；类别 docs；类型 documentation）: 新增的单元测试准入规则，定义了测试编写的分类标准与禁止模式，是本次 PR 的唯一变更文件。

关键符号：未识别


# 评论区精华

PR 无 review 评论，故无讨论亮点。

- 暂无高价值评论线程

# 风险与影响

- 风险：该 PR 仅添加文档规则，无代码变更，无技术风险。但规则的有效性依赖于团队执行，需后续通过 code review 和 CI 来确保遵循。
- 影响：影响范围限于 SRT 团队内部代码审查流程：开发者在编写测试时会参考该规则，从而提升测试质量，减少低价值测试。对系统运行无直接影响。
- 风险标记：暂无

# 关联脉络

- PR #30483 Enhance mechanical refactor proof construction and verification skill: 同为 agent 规则 /skills 更新，基于机械重构验证技能，本 PR 补充了单元测试准入标准。
- PR #28978 Enhance large class styles and code styles: 同为代码风格 / 规则文档，与本 PR 同属开发规范体系。