Skip to main content

向议题添加标签

您可以使用 GitHub Actions 自动标记议题。

Note

GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。

介绍

本教程演示如何使用工作流中的 GitHub CLI 来标记新打开或重新打开的问题。 例如,每次打开或重新打开问题时,都可以添加 triage 标签。 然后,可通过筛选具有 triage 标签的问题来查看需要会审的问题。

GitHub CLI 允许你在工作流中轻松使用 GitHub API。

在本教程中,首先需要创建一个使用 GitHub CLI 的工作流文件。 然后,您将自定义工作流以适应您的需要。

创建工作流程

  1. 选择要应用此项目管理工作流程的仓库。 您可以使用您有写入权限的现有仓库,或者创建一个新的仓库。 有关创建存储库的详细信息,请参阅“创建新仓库”。

  2. 在存储库中,创建一个名为 .github/workflows/YOUR_WORKFLOW.yml 的文件,将 YOUR_WORKFLOW 替换为你选择的名称。 这是一个工作流程文件。 有关在 GitHub 上创建新文件的详细信息,请参阅“创建新文件”。

  3. 将以下 YAML 内容复制到工作流程文件中。

    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_TOKENGH_REPONUMBER 值是使用 githubsecrets 上下文自动设置的。 不需要更改这些值。
    • LABELS 的值更改为你想要添加到此问题的标签列表。 存储库必须存在标签。 使用逗号分隔多个标签。 例如 help wanted,good first issue。 有关标签的详细信息,请参阅“管理标签”。
  5. 将工作流程文件提交到仓库的默认分支。 有关详细信息,请参阅“创建新文件”。

测试工作流程

每次打开或重新打开仓库中的议题时,此工作流程将添加您指定给此议题的标签。

通过在仓库中创建议题来测试工作流程。

  1. 在仓库中创建议题。 有关详细信息,请参阅“创建议题”。
  2. 要查看通过创建议题所触发的工作流程运行,请查看工作流程运行的历史记录。 有关详细信息,请参阅“查看工作流程运行历史记录”。
  3. 当工作流程完成时,您创建的议题应已添加指定的标签。

后续步骤