> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> JiraチケットをDevinに割り当てて、PRにする

<div id="setting-up-the-integration">
  ## 統合の設定
</div>

1. app.devin.ai の Devin アカウントで、[Settings > Connections > Jira](https://app.devin.ai/settings/connections/jira)に移動し、"Connect" をクリックします。
2. Jira にリダイレクトされるので、権限を確認して Devin へのアクセスを許可します。
3. 接続したら、設定ページで **プレイブックラベル** を設定し、必要に応じて **自動化トリガー** も設定します。

<Tip>
  接続後は、**サービスアカウント** も接続することを推奨します。これにより、Devin のコメントは個人アカウントではなくボット名義で表示されます。詳しくは、下記の[サービスアカウントの接続](#connecting-a-service-account)を参照してください。
</Tip>

<div id="how-to-trigger-devin-from-jira">
  ## Jira から Devin をトリガーする方法
</div>

Jira チケットから Devin セッションを開始する方法は 4 つあります。

<div id="assign-the-ticket-to-devin">
  ### チケットをDevinに割り当てる
</div>

JiraでチケットをDevinのサービスアカウントに直接割り当てます。Devinは、[Jira統合設定](https://app.devin.ai/settings/connections/jira)で設定されている**デフォルトのプレイブック**を利用して、チケットの作業を開始します。

<div id="add-a-playbook-label">
  ### プレイブックラベルを追加する
</div>

チケットにプレイブックラベル (例: `!plan`、`!implement`、`!triage`) を追加します。Devin は、ラベルに対応する特定のプレイブックを使用してセッションを開始します。これらのラベルは、統合設定で構成した**プレイブックラベル**に対応しています。これらのラベルは Jira プロジェクトで手動で作成する必要があります。ラベル名は統合設定からコピーしてください。

<div id="add-the-devin-label">
  ### `devin` ラベルを追加する
</div>

任意の Jira 課題に `devin` ラベルを追加します (必要に応じて、最初に Jira プロジェクトでこのラベルを作成してください)。Devin は **デフォルトのプレイブック** を利用してチケットの作業を開始します。

<Note>
  この連携では単語境界一致 (大文字と小文字は区別しない) を利用するため、**devin** を独立した単語として含むラベルであればトリガーされます。たとえば `devin`、`Devin`、`devin-workshop`、`devin-task` です。一方、`devinworkshop` や `devin_workshop` のように、"devin" がより大きな単語の一部になっているラベルではトリガーされません。
</Note>

<div id="mention-devin-in-a-comment">
  ### コメントで Devin を @メンションする
</div>

チケットのコメントで、具体的な指示とともに `@Devin` にメンションします。Devin はセッションを開始し、プレイブックを適用せずに、そのコメントをタスクの指示として利用します。チケットに対してすでにセッションが存在する場合は、そのメッセージが既存のセッションに転送されます。

<div id="setting-up-the-integration">
  ## 統合の設定
</div>

<div id="session-mode">
  ### セッションモード
</div>

セッションモードのトグルでは、Jira のトリガーに対して Devin がどのように応答するかを設定できます。

* **セッションを直接作成** (デフォルトで有効) : Devin は完全なセッションを作成してチケットに取り組み、進捗を Jira に投稿します。
* **スコーピングのみ** (無効) : Devin はチケットを分析するだけで、要約、実装計画、確信度の見積もりを含むスコーピングコメントを投稿します。その後、表示されたリンクをクリックして、手動でセッションを開始できます。

<div id="playbook-labels">
  ### プレイブックラベル
</div>

プレイブックラベルを使うと、どのDevinの[プレイブック](/ja/product-guides/using-playbooks)をJiraのラベルとして使えるようにするかを制御できます。プレイブックを追加すると、そのマクロ (たとえば `!plan`) がラベルになり、そのプレイブックでDevinをトリガーするためにJira課題に割り当てられるようになります。ラベルはJiraプロジェクトで手動で作成する必要があります。ラベル名は統合設定からコピーしてください。

* **デフォルトのプレイブック**: 1つのプレイブックがデフォルトとして設定されます。特定のプレイブックラベルなしでチケットがトリガーされた場合 (たとえば `devin` ラベルだけを付けた場合や、チケットをDevinに割り当てた場合) 、Devinはこのデフォルトのプレイブックを利用します。
* **プレイブックの追加**: 追加のプレイブックを加えるには、"Add playbook" をクリックします。追加できるのは、マクロを持つプレイブックのみです。
* **プレイブックの削除**: プレイブックを削除すると、そのラベルをトリガーとして使えなくなります。

<div id="automation-triggers">
  ### 自動化トリガー
</div>

自動化トリガーを利用すると、Devin はチケットが特定の条件に一致した際に、手動で割り当てたりラベルを付けたりしなくても、自動的に作業を開始できます。トリガーは、次の条件に基づいて設定できます。

* **Projects**: 特定の Jira プロジェクト内のチケットに対してのみトリガーします。
* **Labels**: チケットに特定のラベルが付いている場合にのみトリガーします。
* **Statuses**: チケットが特定のステータス (例: "To Do", "In Progress") になった場合にのみトリガーします。
* **Playbook**: トリガーされたセッションで Devin が利用するプレイブックを、必要に応じて指定できます。

トリガーでは **エッジ検出** を利用します。つまり、チケットがトリガー条件に一致していない状態から一致する状態に変わったとき (例: ラベルが追加された場合やステータスが変更された場合) にのみ発火し、すでに条件に一致しているチケットに対しては発火しません。

<div id="enterprise-jira-project-mapping">
  ### Enterprise: Jira プロジェクトの対応付け
</div>

複数のDevin組織を含むEnterprise環境のデプロイでは、管理者はJiraプロジェクトを特定のDevin組織に対応付けできます。これにより、各Jiraプロジェクトのチケットが正しいDevin組織に振り分けられます。Enterprise環境でJira統合を機能させるには、この対応付けが必要です。

<div id="interacting-with-devin-in-jira">
  ## Jira で Devin とやり取りする
</div>

Devin がチケットの対応を開始すると、Jira を通じて進捗が共有されます。

* **PR リンク**: Devin がプルリクエストを作成すると、その PR の URL が Jira の Jira 課題 にリモートリンクとして自動的に追加され、コメントにも投稿されます。
* **セッションリンク**: Web アプリ内の Devin セッションへの直接リンクも提供されるため、進捗をリアルタイムで確認できます。
* **フォローアップメッセージ**: コメントで `@Devin` にメンションすると、Devin に追加の指示を与えたり、質問したりできます。

<div id="connecting-a-service-account">
  ## サービスアカウントの接続
</div>

管理者アカウントで Jira を接続した後、必要に応じて、OAuth 2.0 のクライアント認証情報を使用してサービスアカウントを接続できます。これにより、Devin のコメントは個人アカウントではなく、専用のボット ID として表示されます。

1. Atlassian 組織の管理者設定で、次の **Classic scopes** を持つ OAuth 2.0 サービスアカウントを作成します：
   * `read:me`
   * `read:jira-user`
   * `read:jira-work`
   * `write:jira-work`
2. サービスアカウントに、Jira の **User** アプリケーションロールが付与されていることを確認します。[Atlassian Admin](https://admin.atlassian.com) で **Directory > Service accounts** に移動し、サービスアカウントを選択して **⋯ > Allow access** をクリックし、Jira ロールを **User** に設定します。これは、サービスアカウントを最初に作成する際にも設定できます。このロールがないと、サービスアカウントは Jira リソースにアクセスできません。
3. [Settings > Connections > Jira](https://app.devin.ai/settings/connections/jira) で、**Connect service account** をクリックし、クライアント ID とクライアントシークレットを入力します。