Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

向议题添加标签

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

简介

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

actions/github-script 操作允许你在工作流中轻松使用 GitHub API。

在本教程中,你将首先创建一个使用 actions/github-script 操作的工作流文件。 然后,您将自定义工作流以适应您的需要。

创建工作流程

  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:
          - uses: actions/github-script@v6
            with:
              script: |
                github.rest.issues.addLabels({
                  issue_number: context.issue.number,
                  owner: context.repo.owner,
                  repo: context.repo.repo,
                  labels: ["triage"]
                })
  4. 自定义工作流文件中的 script 参数:

    • issue_numberownerrepo 值是使用 context 对象自动设置的。 不需要更改这些值。
    • labels 的值更改为你想要添加到此问题的标签列表。 使用逗号分隔多个标签。 例如 ["help wanted", "good first issue"]。 有关标签的详细信息,请参阅管理标签
  5. 将工作流程文件提交到仓库的默认分支。 有关详细信息,请参阅“新建文件”。

测试工作流程

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

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

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

后续步骤