Skip to main content

向议题添加标签

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

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

简介

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

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

创建工作流程

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

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

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

    YAML
    # 此工作流使用未经 GitHub 认证的操作。
    # 它们由第三方提供,并受
    # 单独的服务条款、隐私政策和支持
    # 文档。
    
    # GitHub 建议将操作固定到提交 SHA。
    # 若要获取较新版本,需要更新 SHA。
    # 还可以引用标记或分支,但该操作可能会更改而不发出警告。
    
    name: Label issues
    on:
      issues:
        types:
          - reopened
          - opened
    jobs:
      label_issues:
        runs-on: ubuntu-latest
        permissions:
          issues: write
        steps:
          - name: Label issues
            uses: andymckay/labeler@e6c4322d0397f3240f0e7e30a33b5c5df2d39e90
            with:
              add-labels: "triage"
              repo-token: ${{ secrets.GITHUB_TOKEN }}
  4. 自定义工工作流程文件中的参数:

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

测试工作流程

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

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

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

后续步骤

  • 若要详细了解可以使用 andymckay/labeler 操作执行的其他操作,例如删除标签或者在问题分配或具有特定标签时跳过此操作,请参阅 andymckay/labeler 操作文档
  • 若要详细了解可以触发工作流的不同事件,请参阅可触发工作流的事件andymckay/labeler 操作仅适用于 issuespull_requestproject_card 事件。
  • 搜索 GitHub 以获取使用此操作的工作流示例。