执行摘要

• 一句话：CI工作流支持labeled事件重新触发
• 推荐动作：该 PR 设计完善，文档清晰，推荐 CI 管理者精读。值得关注的设计决策是通过 labeled 事件绕开 run.rerun() 不可用的问题，这是一个很好的 GitHub Actions 实践。建议后续为 handler 增加单元测试。

功能与动机

当 CI 工作流因缺少标签而被跳过时，GitHub 的 run.rerun() 会复用原始事件载荷，无法恢复标签跳过状态。开发者需要额外 push 或手动重触发才能让 CI 运行。该 PR 通过监听 labeled 事件，使得添加缺失标签后立即触发一次新的完整工作流，从而无需额外提交即可恢复 CI。

实现拆解

1. 工作流事件扩展（.github/workflows/pr-test-extra.yml）：在 pull_request 的 types 中增加 labeled，使添加标签时触发新工作流。
2. 标签门控增强：在 check-changes job 的 if 条件中，对于 labeled 事件额外校验刚添加的标签是否为 run-ci 或 run-ci-extra，避免无关标签触发全量 CI。
3. Slash 命令 handler 扩展（scripts/ci/utils/slash_command_handler.py）：为 handle_tag_run_ci 函数增加 tag_extra 参数，当用户执行 /tag-run-ci-label extra 时同时添加 run-ci 和 run-ci-extra 两个标签。
4. 文档更新：更新两份贡献指南（contribution_guide.mdx 和 ascend_contribution_guide.mdx）中的命令说明；更新 .claude/skills/ci-workflow-guide/SKILL.md 解释 labeled 事件机制及其与 rerun 的差异。

关键文件：

• scripts/ci/utils/slash_command_handler.py（模块 CI脚本；类别 infra；类型 infrastructure；符号 handle_tag_run_ci）: 核心逻辑文件：扩展 handle_tag_run_ci 函数，支持通过 extra 参数同时添加 run-ci-extra 标签。
• .github/workflows/pr-test-extra.yml（模块 CI工作流；类别 infra；类型 infrastructure）: 工作流配置变更：添加 labeled 事件类型并在 check-changes 中增加标签名过滤。
• .claude/skills/ci-workflow-guide/SKILL.md（模块 CI文档；类别 docs；类型 documentation）: 文档更新：详细解释了 labeled 事件机制及其与 rerun 的差异，帮助开发者理解 CI 触发逻辑。
• docs_new/docs/developer_guide/contribution_guide.mdx（模块 开发文档；类别 other；类型 documentation）: 同步更新贡献指南中的命令说明，增加 extra 参数描述。
• docs_new/docs/hardware-platforms/ascend-npus/ascend_contribution_guide.mdx（模块 开发文档；类别 other；类型 documentation）: 同步更新 Ascend 贡献指南，与主贡献指南保持一致。

关键符号：handle_tag_run_ci

关键源码片段

.github/workflows/pr-test-extra.yml

工作流配置变更：添加 labeled 事件类型并在 check-changes 中增加标签名过滤。

# .github/workflows/pr-test-extra.yml (partial)
name: PR Test Extra
on:
  pull_request:
    branches: [main]
    # 新增 labeled 事件类型，使得添加标签时能重新触发工作流
    types: [opened, synchronize, reopened, labeled]
  workflow_dispatch:
    inputs:
      force_continue_on_error:
​
jobs:
  check-changes:
    if: |
      github.event_name != 'pull_request' || (
        # 对于 labeled 事件，额外校验刚添加的标签是否为 gating 标签之一
        (github.event.action != 'labeled' ||
         github.event.label.name == 'run-ci' ||
         github.event.label.name == 'run-ci-extra') &&
        # 当前 PR 必须同时包含 run-ci 和 run-ci-extra 标签
        contains(github.event.pull_request.labels.*.name, 'run-ci') &&
        contains(github.event.pull_request.labels.*.name, 'run-ci-extra')
      )

评论区精华

无有效的 review 讨论。仅有一条 bot 评论提示达到每日限额，不涉及技术内容。

• 暂无高价值评论线程

风险与影响

• 风险：
  1. 标签处理逻辑：handle_tag_run_ci 中如果 tag_extra=True 但权限检查失败，继续执行后续逻辑可能导致不一致，需确认提前返回。目前该函数在权限不足时返回 False 且不会添加标签，符合预期。
  2. 工作流门控条件：新增的 labeled 类型和标签名检查可能因 GitHub API 变化而失效，但此为标准事件机制。
  3. 并发标签事件：若用户快速连续添加/移除标签，可能触发多次工作流，但因 check-changes 中依赖 github.event.label.name 和当前 PR 标签集，多次触发不会导致错误，仅浪费运行资源。
  4. 无单元测试覆盖：未针对 slash command handler 新增逻辑编写测试，存在回归风险。
     - 影响：对开发者：CI 触发体验改善，添加标签后立即生效，无需额外 push。对系统：工作流运行次数可能增加，但因需要特定标签，影响可控。对团队：维护者更容易通过命令控制 CI 运行，提升工作效率。影响范围限于 CI 基础设施，不涉及模型推理或服务性能。
     - 风险标记：CI触发逻辑变更, 标签权限检查, 无单元测试覆盖

关联脉络

• 暂无明显关联 PR