{"meta":{"title":"Issue にラベルを追加する","intro":"GitHub Actions を使用して、問題に自動的にラベルを付けることができます。","product":"GitHub Actions","breadcrumbs":[{"href":"/ja/enterprise-cloud@latest/actions","title":"GitHub Actions"},{"href":"/ja/enterprise-cloud@latest/actions/tutorials","title":"チュートリアル"},{"href":"/ja/enterprise-cloud@latest/actions/tutorials/manage-your-work","title":"作業を管理する"},{"href":"/ja/enterprise-cloud@latest/actions/tutorials/manage-your-work/add-labels-to-issues","title":"課題にラベルを追加する"}],"documentType":"article"},"body":"# Issue にラベルを追加する\n\nGitHub Actions を使用して、問題に自動的にラベルを付けることができます。\n\n## はじめに\n\nこのチュートリアルでは、ワークフローで  GitHub CLI を使用して、新しくオープンまたは再オープンした Issue にラベルを付ける方法を示しています。 たとえば、Issue をオープンまたは再オープンするたびに `triage` ラベルを追加できます。 次に、`triage` ラベルで Issue をフィルター処理して、トリアージする必要のあるすべての Issue を確認できます。\n\nGitHub CLI を使うと、ワークフローで GitHub API を簡単に使用できます。\n\nこのチュートリアルでは、まず GitHub CLI を使用するワークフロー ファイルを作成します。 次に、ニーズに合わせてワークフローをカスタマイズします。\n\n## ワークフローの作成\n\n1. このプロジェクト管理ワークフローを適用したいリポジトリを選択してください。 書き込みアクセス権を持つ既存のリポジトリを利用することも、新しいリポジトリを作成することもできます。 リポジトリの作成について詳しくは、「[新しいリポジトリの作成](/ja/enterprise-cloud@latest/repositories/creating-and-managing-repositories/creating-a-new-repository)」をご覧ください。\n\n2. リポジトリに `.github/workflows/YOUR_WORKFLOW.yml` というファイルを作成します (`YOUR_WORKFLOW` は任意の名前に置き換えます)。 これがワークフローファイルです。 GitHub での新しいファイルの作成について詳しくは、「[新しいファイルの作成](/ja/enterprise-cloud@latest/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` 」のように入力します。 ラベルについて詳しくは、「[ラベルを管理する](/ja/enterprise-cloud@latest/issues/using-labels-and-milestones-to-track-work/managing-labels#applying-labels-to-issues-and-pull-requests)」をご覧ください。\n\n5. ワークフローファイルを、リポジトリのデフォルトブランチにコミットしてください。 詳しくは、「[新しいファイルの作成](/ja/enterprise-cloud@latest/repositories/working-with-files/managing-files/creating-new-files)」をご覧ください。\n\n## ワークフローのテスト\n\nリポジトリ内の Issue をオープンするか再オープンするたびに、このワークフローは指定したラベルを Issue に追加します。\n\nリポジトリに Issue を作成して、ワークフローをテストします。\n\n1. リポジトリで Issue を作成します。 詳しくは、「[課題の作成](/ja/enterprise-cloud@latest/issues/tracking-your-work-with-issues/creating-an-issue)」をご覧ください。\n2. Issue の作成によってトリガーされたワークフローの実行を確認するには、ワークフローの実行履歴を表示します。 詳しくは、「[ワークフロー実行の履歴を表示する](/ja/enterprise-cloud@latest/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)」をご覧ください。\n3. ワークフローが完了すると、作成した Issue に指定されたラベルが追加されます。\n\n## 次のステップ\n\n* GitHub CLI で実行できるその他の操作の詳細については、[GitHub CLI のマニュアル](https://cli.github.com/manual/)を参照してください。\n* ワークフローをトリガーできるさまざまなイベントについて詳しくは、「[ワークフローをトリガーするイベント](/ja/enterprise-cloud@latest/actions/using-workflows/events-that-trigger-workflows#issues)」をご覧ください。\n* [Search GitHub](https://github.com/search?q=path%3A.github%2Fworkflows+gh+issue+edit\\&type=code)`gh issue edit` を使用したワークフローの例を示します。"}