向议题添加标签

简介

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

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

创建工作流程

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

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

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

   YAML

   # 此工作流使用未经 GitHub 认证的操作。
   # 它们由第三方提供，并受
   # 单独的服务条款、隐私政策和支持
   # 文档管理。
   
   name: Label issues
   on:
     issues:
       types:
         - reopened
         - opened
   jobs:
     label_issues:
       runs-on: ubuntu-latest
       steps:
         - name: Label issues
           uses: andymckay/labeler@5c59dabdfd4dd5bd9c6e6d255b01b9d764af4414
           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 操作只适用于 issues、pull_request 或 project_card 事件。
• 搜索 GitHub 以查看使用此操作的工作流程示例。