使用 GitHub Actions 自动向议题添加标签

简介

本教程演示如何在工作流中使用 GitHub CLI，为新建或重新打开的议题添加标签。例如，每次新建或重新打开议题时，都添加 triage 标签。随后可以按此标签筛选议题，查看需要分流处理的内容。

GitHub CLI 让工作流能够方便地使用 GitHub API。本教程先创建一个使用 GitHub CLI 的工作流文件，再根据实际需要调整它。

创建工作流

1. 选择要应用此项目管理工作流的仓库。可以使用已有写入权限的仓库，也可以创建新仓库。
2. 在仓库中创建 .github/workflows/YOUR_WORKFLOW.yml，将 YOUR_WORKFLOW 替换为你选择的名称。该文件即工作流文件。文件创建方法见创建新文件。
3. 将以下 YAML 复制到工作流文件中：

name: Label issues
on:
  issues:
    types:
      - reopened
      - opened
jobs:
  label_issues:
    runs-on: ubuntu-latest
    permissions:
      issues: write
    steps:
      - run: gh issue edit "$NUMBER" --add-label "$LABELS"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          GH_REPO: ${{ github.repository }}
          NUMBER: ${{ github.event.issue.number }}
          LABELS: triage

4. 按需调整 env 中的值：

• GH_TOKEN、GH_REPO 和 NUMBER 通过 github 与 secrets 上下文自动设置，无需修改。
• 将 LABELS 改为要添加的标签列表。这些标签必须已经存在于仓库中。 多个标签使用逗号分隔，例如 help wanted,good first issue。参阅管理标签。

5. 将工作流文件提交到仓库的默认分支。

测试工作流

每次在仓库中新建或重新打开议题时，该工作流都会为议题添加指定标签。可以通过新建议题来测试：

1. 在仓库中创建议题。
2. 查看此次创建议题所触发的工作流运行，参阅查看工作流运行历史记录。
3. 工作流完成后，检查新议题是否已带有所指定的标签。

后续步骤

• 参阅 GitHub CLI 手册，了解其他可执行操作。
• 参阅触发工作流的事件，了解其他触发条件。
• 在 GitHub 上搜索使用 GitHub CLI 的工作流示例。

来源：向议题添加标签，GitHub 文档团队。本文依据官方中文页整理措辞，保留完整操作内容及 YAML。官方页面提示部分内容可能由机器或 AI 翻译。文档仓库采用 CC BY 4.0。© 2026 GitHub, Inc. 本稿未在仓库运行工作流。