Prhub

#24774 docs: clarify how /tag-and-rerun-ci kicks off CI on the current commit

原始 PR 作者 ByronHsu 合并时间 2026-05-10 11:28 文件变更 2 提交数 3 评论 1 代码增减 +8 / -8

documentation

执行摘要

澄清 CI 斜杠命令文档说明

原有文档描述模糊，如 /tag-run-ci-label 的说明‘Every future commit will trigger CI’容易让人误以为当前提交也会触发 CI，实际需要通过 /rerun-failed-ci 或组合命令才能对当前提交生效。PR 想要消除这一歧义，帮助贡献者正确使用 CI 命令。

小型文档改进，贡献者可快速了解，不需要深入精读。但体现了对开发者体验的重视，值得认可。

讨论亮点

无实质性讨论。有一条 gemini-code-assist bot 的自动评论提示配额已满，不影响审核。审核者 ispobock 直接批准。

实现拆解

  1. 修改 docs/developer_guide/contribution_guide.md：调整四个斜杠命令的 bullet 描述，将 /tag-run-ci-label 明确为仅影响未来提交；将 /rerun-failed-ci 补充为包含 skipped 状态；新增说明 /tag-and-rerun-ci 用于新 PR 上触发 CI。
  2. 同步修改 docs/platforms/ascend/ascend_contribution_guide.md：应用完全相同的变更，确保 Ascend 平台指南保持一致。
  3. 无测试或配置变更，纯文档更新。
文件 模块 状态 重要度
docs/developer_guide/contribution_guide.md 开发者指南 modified 2.1
docs/platforms/ascend/ascend_contribution_guide.md 平台文档 modified 2.1

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

评论区精华

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

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

风险与影响

无技术风险。仅修改文档描述，不影响任何代码逻辑或 CI 行为。

  • 用户影响：改善贡献者对 CI 斜杠命令的理解，减少误用导致的沟通成本。
  • 系统影响：无。
  • 团队影响：维护成本低，但提升了文档清晰度。

关联 Issue

未识别关联 Issue

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

完整报告

Markdown PDF

参与讨论