{"meta":{"title":"向议题添加标签","intro":"您可以使用 GitHub Actions 自动标记议题。","product":"GitHub Actions","breadcrumbs":[{"href":"/zh/actions","title":"GitHub Actions"},{"href":"/zh/actions/tutorials","title":"教程"},{"href":"/zh/actions/tutorials/manage-your-work","title":"管理你的工作"},{"href":"/zh/actions/tutorials/manage-your-work/add-labels-to-issues","title":"将标签添加到问题"}],"documentType":"article"},"body":"# 向议题添加标签\n\n您可以使用 GitHub Actions 自动标记议题。\n\n## 简介\n\n本教程演示如何使用工作流中的 GitHub CLI 来标记新打开或重新打开的问题。 例如，每次打开或重新打开问题时，都可以添加 `triage` 标签。 然后，您可以通过筛选具有 `triage` 标签的问题，查看需要分类的问题。\n\nGitHub CLI 允许你在工作流中轻松使用 GitHub API。\n\n在本教程中，首先需要创建一个使用 GitHub CLI 的工作流文件。 然后，您将自定义工作流以适应您的需要。\n\n## 创建工作流程\n\n1. 选择要应用此项目管理工作流程的仓库。 您可以使用您有写入权限的现有仓库，或者创建一个新的仓库。 有关创建仓库的详细信息，请参阅 [创建新仓库](/zh/repositories/creating-and-managing-repositories/creating-a-new-repository)。\n\n2. 在存储库中，创建一个名为 `.github/workflows/YOUR_WORKFLOW.yml` 的文件，将 `YOUR_WORKFLOW` 替换为你选择的名称。 这是一个工作流程文件。 有关在 GitHub 上创建新文件的详细信息，请参阅 [创建新文件](/zh/repositories/working-with-files/managing-files/creating-new-files)。\n\n3. 将以下 YAML 内容复制到工作流程文件中。\n\n   ```yaml copy\n   name: Label issues\n   on:\n     issues:\n       types:\n         - reopened\n         - opened\n   jobs:\n     label_issues:\n       runs-on: ubuntu-latest\n       permissions:\n         issues: write\n       steps:\n         - run: gh issue edit \"$NUMBER\" --add-label \"$LABELS\"\n           env:\n             GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n             GH_REPO: ${{ github.repository }}\n             NUMBER: ${{ github.event.issue.number }}\n             LABELS: triage\n   ```\n\n4. 自定义工作流文件中的 `env` 值：\n   * `GH_TOKEN`、`GH_REPO`和 `NUMBER` 值是使用 `github` 和 `secrets` 上下文自动设置的。 不需要更改这些值。\n   * 将 `LABELS` 的值更改为你想要添加到此问题的标签列表。 您的存储库必须存在标签。 使用逗号分隔多个标签。 例如，`help wanted,good first issue`。 有关标签的详细信息，请参阅 [管理标签](/zh/issues/using-labels-and-milestones-to-track-work/managing-labels#applying-labels-to-issues-and-pull-requests)。\n\n5. 将工作流程文件提交到仓库的默认分支。 有关详细信息，请参阅“[创建新文件](/zh/repositories/working-with-files/managing-files/creating-new-files)”。\n\n## 测试工作流程\n\n每次打开或重新打开仓库中的议题时，此工作流程将添加您指定给此议题的标签。\n\n通过在你的仓库中创建问题来测试工作流程。\n\n1. 在仓库中创建议题。 有关详细信息，请参阅“[创建议题](/zh/issues/tracking-your-work-with-issues/creating-an-issue)”。\n2. 要查看通过创建议题所触发的工作流程运行，请查看工作流程运行的历史记录。 有关详细信息，请参阅“[查看工作流程运行历史记录](/zh/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)”。\n3. 当工作流程完成时，您创建的议题应已添加指定的标签。\n\n## 后续步骤\n\n* 若要了解有关 GitHub CLI 可以执行的其他操作的详细信息，请参阅 [GitHub CLI 手册](https://cli.github.com/manual/)。\n* 若要详细了解可以触发工作流的不同事件，请参阅“[触发工作流的事件](/zh/actions/using-workflows/events-that-trigger-workflows#issues)”。\n* 在 GitHub 上搜索有关使用 [](https://github.com/search?q=path%3A.github%2Fworkflows+gh+issue+edit\\&type=code) 的工作流示例。"}