将卡片添� 到项目板列时� 除� �签

简介

本教程演示如何使用 andymckay/labeler 操作和条件，从已添� 到项目板上指定列的议题和拉取请求中� 除� �签。 例如，可以在项目卡移至 Done 列后� 除 needs review � �签。

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

创建工作流程

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

2. 选择属于仓库的项目。 此工作流程不能用于属于用户或组织的项目。 您可以使用现有项目，也可以创建新项目。 有关如何创建项目的详细信息，请参阅“创建项目板”。

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

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

   YAML

   # 此工作流使用未经 GitHub 认证的操作。
   # 它们由第三方提供，并受
   # 单独的服务条款、隐私政策和支持
   # 文档。
   
   # GitHub 建议将操作固定到提交 SHA。
   # 若要获取较新版本，需要更新 SHA。
   # 还可以引用� �记或分支，但该操作可能会更改而不发出警告。
   
   name: Remove labels
   on:
     project_card:
       types:
         - moved
   jobs:
     remove_labels:
       if: github.event.project_card.column_id == '12345678'
       runs-on: ubuntu-latest
       permissions:
         issues: write
         pull-requests: write
       steps:
         - name: remove labels
           uses: andymckay/labeler@5c59dabdfd4dd5bd9c6e6d255b01b9d764af4414
           with:
             remove-labels: "needs review"
             repo-token: ${{ secrets.GITHUB_TOKEN }}

5. 自定义工工作流程文件中的参数：

   • 在 github.event.project_card.column_id == '12345678' 中，将 12345678 替换为要取消� �记移至其中的议题和拉取请求的列 ID。

     要查找列 ID，请导航到您的项目板。 在列� �题旁边，请单击 ，然后单击“复制列链接”。 列 ID 是复制的链接末尾的数字。 例如，24687531 是 https://github.com/octocat/octo-repo/projects/1#column-24687531 的列 ID。

     如果想要在多个列上操作，请使用 || 分隔条件。 例如，只要项目卡添� 到了列 12345678 或列 87654321，就会使用 if github.event.project_card.column_id == '12345678' || github.event.project_card.column_id == '87654321'。 这些列可能在不同的项目板上。

   • 将 remove-labels 的值更改为要从移至指定列的议题或拉取请求中� 除的� �签列表。 使用逗号分隔多个� �签。 例如 "help wanted, good first issue"。 有关� �签的详细信息，请参阅“管理� �签”。

6. 将工作流程文件提交到仓库的默认分支。 有关详细信息，请参阅“新建文件”。

测试工作流程

每次仓库中项目上的项目卡移动时，此工作流程都会运行。 如果卡是议题或拉取请求，并移入您指定的列，则工作流程将从问题或拉取请求中� 除指定的� �签。 记事卡不会受到影响。

通过将项目上的议题移到目� �列中来测试工作流程。

1. 在仓库中打开一个议题。 有关详细信息，请参阅“创建议题”。
2. 用� �签� �记您想要工作流程� 除的议题。 有关详细信息，请参阅“管理� �签”。
3. 将议题添� 到您在工作流程文件中指定的项目列。 有关详细信息，请参阅“向项目板添� 议题和拉取请求”。
4. 要查看通过将议题添� 到项目所触发的工作流程运行，请查看工作流程运行的历史记录。 有关详细信息，请参阅“查看工作流运行历史记录”。
5. 当工作流程完成时，您添� 到项目列的议题应已� 除指定的� �签。

后续步骤

• 若要详细了解可以使用 andymckay/labeler 操作执行的其他操作，例如添� � �签或者在议题分配或具有特定� �签时跳过此操作，请访问 andymckay/labeler 操作文档。
• 搜索 GitHub 以获取使用此操作的工作流示例。