# ラベルが追加されたときに Issue にコメントする

GitHub Actions を使用して、特定のラベルが適用されたときに Issue に自動的にコメントすることができます。

## はじめに

このチュートリアルでは、GitHub CLI を使用して、特定のラベルが適用されたときに Issue にコメントする方法を示します。 たとえば、`help wanted` ラベルが Issue に追加されたときに、コメントを追加して、共同作成者に Issue への対応を促すことができます。 GitHub CLI について詳しくは、「[ワークフローでの GitHub CLI の使用](/ja/actions/using-workflows/using-github-cli-in-workflows)」をご覧ください。

チュートリアルでは、まず `gh issue comment` コマンドを使用するワークフロー ファイルを作成して Issue にコメントします。 次に、ニーズに合わせてワークフローをカスタマイズします。

## ワークフローの作成

1. このプロジェクト管理ワークフローを適用したいリポジトリを選択してください。 書き込みアクセス権を持つ既存のリポジトリを利用することも、新しいリポジトリを作成することもできます。 リポジトリの作成について詳しくは、「[新しいリポジトリの作成](/ja/repositories/creating-and-managing-repositories/creating-a-new-repository)」をご覧ください。

2. リポジトリに `.github/workflows/YOUR_WORKFLOW.yml` というファイルを作成します (`YOUR_WORKFLOW` は任意の名前に置き換えます)。 これがワークフローファイルです。 GitHub での新しいファイルの作成について詳しくは、「[新しいファイルの作成](/ja/repositories/working-with-files/managing-files/creating-new-files)」をご覧ください。

3. 次の YAML コンテンツをワークフローファイルにコピーします。

   ```yaml copy
   name: Add comment
   on:
     issues:
       types:
         - labeled
   jobs:
     add-comment:
       if: github.event.label.name == 'help wanted'
       runs-on: ubuntu-latest
       permissions:
         issues: write
       steps:
         - name: Add comment
           run: gh issue comment "$NUMBER" --body "$BODY"
           env:
             GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
             GH_REPO: ${{ github.repository }}
             NUMBER: ${{ github.event.issue.number }}
             BODY: >
               This issue is available for anyone to work on.
               **Make sure to reference this issue in your pull request.**
               :sparkles: Thank you for your contribution! :sparkles:
   ```

4. ワークフローファイルのパラメータをカスタマイズします。
   * `help wanted` の `if: github.event.label.name == 'help wanted'` を操作するラベルに置き換えます。 複数のラベルを操作する場合、条件を `||` で区切ります。 たとえば、`if: github.event.label.name == 'bug' || github.event.label.name == 'fix me'` は、`bug` または `fix me` のラベルが Issue に追加されるたびにコメントします。
   * `BODY` の値を追加したいコメントに変更します。 GitHubフレーバー マークダウンがサポートされています。 Markdown について詳しくは、「[基本的な書き込みと書式設定の構文](/ja/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)」をご覧ください。

5. ワークフローファイルを、リポジトリのデフォルトブランチにコミットしてください。 詳しくは、「[新しいファイルの作成](/ja/repositories/working-with-files/managing-files/creating-new-files)」をご覧ください。

## ワークフローのテスト

リポジトリ内の Issue にラベルが付けられるたびに、このワークフローが実行されます。 追加されたラベルがワークフロー ファイルで指定したラベルの 1 つである場合、指定したコメントが `gh issue comment` コマンドによって Issue に追加されます。

指定したラベルを Issue に適用して、ワークフローをテストします。

1. リポジトリで Issue をオープンします。 詳しくは、「[課題の作成](/ja/issues/tracking-your-work-with-issues/creating-an-issue)」をご覧ください。
2. ワークフローファイル内の指定されたラベルで Issue にラベルを付けます。 詳しくは、「[ラベルを管理する](/ja/issues/using-labels-and-milestones-to-track-work/managing-labels#applying-labels-to-issues-and-pull-requests)」をご覧ください。
3. Issue のラベル付けによってトリガーされたワークフローの実行を確認するには、ワークフローの実行履歴を表示します。 詳しくは、「[ワークフロー実行の履歴を表示する](/ja/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)」をご覧ください。
4. ワークフローが完了すると、ラベルを付けた Issue にコメントが追加されます。

## 次のステップ

* 既存のコメントの編集など、GitHub CLI で実行できるその他の操作の詳細については、[GitHub CLI マニュアル](https://cli.github.com/manual/)を参照してください。