Prhub

#21264 docs: update add-jit-kernel skill for run_suite CI registration

sgl-project/sglang · 作者 merrymercy · 合并时间 2026-03-24 12:31

分析状态 已生成
文件变更 1提交数 1 · 评论 1
代码增减 +43 / -2
documentation ci test jit-kernel

执行摘要

更新 JIT 内核技能文档以适配新的 `run_suite.py` CI 注册流程。

PR body中说明:'Updates .claude/skills/add-jit-kernel/SKILL.md to match the JIT kernel CI flow after the refactor to test/run_suite.py and register_cuda_ci (see #21239 / commit 260abe1).',动机是保持文档与代码变更同步,避免因文档过时导致开发者错误配置JIT内核测试和基准。

建议开发者快速浏览此PR以了解JIT内核CI注册的新流程,关注register_cuda_ci的使用和套件名称,无需深入分析代码设计,仅作为文档更新参考。

讨论亮点

无review讨论,变更由作者直接合并,表明文档更新已被接受无需额外审查。

实现拆解

实现集中在单个文件.claude/skills/add-jit-kernel/SKILL.md的更新,关键改动点包括:1) 文档化测试和基准通过test/run_suite.py的AST解析发现机制,取代直接运行pytest;2) 引入register_cuda_ci函数、套件名称(如stage-b-kernel-unit-1-gpu-large)和可选参数(如nightly=Truedisabled=);3) 提供测试文件和基准文件的示例代码;4) 添加故障排除指南,处理缺失CI注册或AST解析问题。

文件 模块 状态 重要度
.claude/skills/add-jit-kernel/SKILL.md documentation/skills modified 3.0

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

关键符号

register_cuda_ci

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

风险较低,主要涉及文档准确性:1) 如果文档错误或过时,可能导致开发者错误注册测试,影响CI运行;2) 依赖AST解析的机制未被深入验证,但文档已提供故障排除指南。无代码或CI行为变更,不引入回归、性能或安全风险。

影响范围主要针对开发者团队:确保JIT内核测试和基准的正确注册,提升CI流程清晰度,尤其对新贡献者有帮助。对系统无直接影响,影响程度中等,仅限于JIT内核模块的CI配置和文档指导。

文档过时风险

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

执行摘要

本PR更新了JIT内核技能文档以适配重构后的CI流程,通过test/run_suite.pyregister_cuda_ci注册机制,确保开发者正确设置测试和基准。作为纯文档变更,风险低,但对团队CI配置有重要指导作用。

功能与动机

为解决CI重构(如引用#21239)后的文档不一致问题,本PR旨在更新.claude/skills/add-jit-kernel/SKILL.md,使其匹配新的JIT内核测试流程。动机直接来自PR body:"Updates .claude/skills/add-jit-kernel/SKILL.md to match the JIT kernel CI flow after the refactor to test/run_suite.py and `register_cuda_ci",强调保持文档同步以避免配置错误。

实现拆解

  • 文件变更:仅修改.claude/skills/add-jit-kernel/SKILL.md,增43行、删2行。
  • 关键内容
    • 明确测试和基准通过test/run_suite.py的AST解析发现,而非直接运行pytest
    • 文档化register_cuda_ci函数,例如:
      python from sglang.test.ci.ci_register import register_cuda_ci register_cuda_ci(est_time=30, suite="stage-b-kernel-unit-1-gpu-large")
  • 列出套件名称:stage-b-kernel-unit-1-gpu-largestage-b-kernel-benchmark-1-gpu-largenightly-kernel-1-gpu
  • 添加示例测试和基准文件代码,以及故障排除指南。

评论区精华

无review讨论,变更由作者直接合并,表明文档更新已被快速接受,无需技术争议。

风险与影响

  • 风险:文档准确性风险,若错误可能导致开发者注册失败,但无代码变更,回归风险低。
  • 影响:提升团队对JIT内核CI流程的理解,影响范围限于文档用户,对新贡献者尤为重要,有助于减少配置时间。

关联脉络

  • 与PR #21202(文档改进)关联,同属CI和测试文档更新脉络,反映团队在持续优化文档质量。
  • 与PR #21219(CI拆分)关联,其重构可能促成本次文档更新,展示CI流程演进对文档的依赖关系。

参与讨论