{"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-comments-with-labels","title":"添加带标签的注释"}],"documentType":"article"},"body":"# 当添加标签时对议题发表评论\n\n您可以使用 GitHub Actions 在应用特定标签时自动评论议题。\n\n## 简介\n\n本教程将演示如何在应用特定标签时使用 GitHub CLI 来添加有关问题的注释。 例如，当 `help wanted` 标签添加到问题中后，可以添加注释来建议参与者处理该问题。 有关 GitHub CLI 的详细信息，请参阅 [在工作流中使用 GitHub CLI](/zh/actions/using-workflows/using-github-cli-in-workflows)。\n\n在本教程中，你将首先创建一个使用 `gh issue comment` 命令添加问题注释的工作流文件。 然后，您将自定义工作流以适应您的需要。\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: Add comment\n   on:\n     issues:\n       types:\n         - labeled\n   jobs:\n     add-comment:\n       if: github.event.label.name == 'help wanted'\n       runs-on: ubuntu-latest\n       permissions:\n         issues: write\n       steps:\n         - name: Add comment\n           run: gh issue comment \"$NUMBER\" --body \"$BODY\"\n           env:\n             GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n             GH_REPO: ${{ github.repository }}\n             NUMBER: ${{ github.event.issue.number }}\n             BODY: >\n               This issue is available for anyone to work on.\n               **Make sure to reference this issue in your pull request.**\n               :sparkles: Thank you for your contribution! :sparkles:\n   ```\n\n4. 自定义工作流程文件中的参数。\n   * 将 `help wanted` 中的 `if: github.event.label.name == 'help wanted'` 替换为要处理的标签。 如果想要在多个标签上操作，请使用 `||` 分隔条件。 例如，`if: github.event.label.name == 'bug' || github.event.label.name == 'fix me'` 将在 `bug` 或 `fix me` 标签添加到问题时进行注释。\n   * 将 `BODY` 的值更改为要添加的注释。 支持 GitHub 风格的 Markdown。 有关 Markdown 的详细信息，请参阅“[基本写作和格式语法](/zh/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)”。\n\n5. 将工作流程文件提交到仓库的默认分支。 有关详细信息，请参阅“[创建新文件](/zh/repositories/working-with-files/managing-files/creating-new-files)”。\n\n## 测试工作流程\n\n每当仓库中的问题被标记时，此工作流就会运行。 如果添加的标签是工作流文件中指定的标签之一，`gh issue comment` 命令将添加你为该问题指定的注释。\n\n通过将指定的标签应用于议题来测试工作流程。\n\n1. 在仓库中打开一个议题。 有关详细信息，请参阅“[创建议题](/zh/issues/tracking-your-work-with-issues/creating-an-issue)”。\n2. 使用工作流程文件中的指定标签标记议题。 有关详细信息，请参阅“[管理标签](/zh/issues/using-labels-and-milestones-to-track-work/managing-labels#applying-labels-to-issues-and-pull-requests)”。\n3. 要查看通过标记议题所触发的工作流程运行，请查看工作流程运行的历史记录。 有关详细信息，请参阅“[查看工作流程运行历史记录](/zh/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)”。\n4. 当工作流程完成时，应在您标记的议题上添加一条评论。\n\n## 后续步骤\n\n* 若要详细了解可以使用 GitHub CLI 执行的其他作（如编辑现有注释），请访问 [GitHub CLI 手册](https://cli.github.com/manual/)。"}