Jira を使う
Jira を接続しておくと、エージェントが jira コマンドで課題を読み、起票し、コメントし、ステータスを進められます。
どのエージェントでも、セッションの中でのログインは要りません。
| あなたがやること | エージェントがやること |
|---|---|
| Jira を接続する | jira コマンドで課題を読む・作る・更新する |
| やってほしいことを頼む | あなたの Jira アカウントとして書き込む |
| 接続が切れたらつなぎ直す | 接続が使えないときは、そう伝えて止まる |
jira は、接続した Jira アカウントの権限で動きます。エージェントは最初から使い方を知っているので、コマンドを教える必要はありません。
OAuth のトークンは呼び出しのたびに確かめられ、期限が近づくと更新されるので、そのためにセッションを再起動することはありません。
⚙設定 →「課題管理」 で Jira を接続します。手順は 課題管理サービスを接続する にあります。
- 接続は OAuth でも API トークンでもかまいません
- Jira Cloud（
….atlassian.net）だけです。Jira Data Center は自分で設定します
エージェントに頼む
Section titled “エージェントに頼む”ふだんどおりにお願いするだけです。
PROJ-123 を読んで、直し方の案をコメントして
今の作業内容で PROJ に課題を起票して。親は PROJ-100 で
PROJ-123 を「In Progress」に進めて、担当を自分にして
エージェントは次のようなことができます。
| やること | 例 |
|---|---|
| 課題を読む・探す | jira issue view PROJ-1、jira issue list -p PROJ |
| 課題を作る | jira issue create -p PROJ（親は -P PROJ-100） |
| コメントする | jira issue comment add PROJ-1 "…" |
| コメントを直す・消す | jira issue comment edit PROJ-1 10001 -b "…"、jira issue comment delete PROJ-1 10001 |
| ステータスを進める | jira issue move PROJ-1 "In Progress" |
| 担当者を決める | jira issue assign PROJ-1 <ユーザー> |
- 書き込みはあなたの名前で残ります。 できることは、あなたの Jira アカウントに許されている範囲までです
- コメントや説明文は Markdown で書けます。 日本語の隣の
codeや 太字、リスト、表も、書いたとおりに Jira に表示されます - コメントの ID は
jira issue view PROJ-1 --rawの.fields.comment.comments[].idでわかります - 直したり消したりするコメントは決まっています。 エージェントには、そのセッションで自分が書いたコメントか、あなたが指定したコメントだけを 編集・削除するよう伝えてあります
- 作った課題の親は確かめてください。 親を付けて作ると、Agent Fleet が親を確実に送るように調整しますが、すべての種類のプロジェクトでは確かめられていません
ボード・スプリント・エピックを使う
Section titled “ボード・スプリント・エピックを使う”ボード・スプリント・エピックを扱うには、プロジェクトとボードを一度設定しておきます。エージェントに頼めば実行してくれます。
jira init --project PROJ --board "PROJ board"- 正確なボード名は
jira board list -p PROJでわかります - 設定をやり直すときは
--forceを付けます - 設定しないときは、コマンドごとに
-p PROJを付ければ課題は扱えます
2 つ目のボードは、専用の設定ファイルを作って使います。接続が使われるのは ~/.config/agent-fleet/jira/ の中の設定ファイルだけです。
jira init -c ~/.config/agent-fleet/jira/other-board.yml --project PROJ --board "Other board"jira -c ~/.config/agent-fleet/jira/other-board.yml sprint listAtlassian の MCP ツールを使わせたいとき
Section titled “Atlassian の MCP ツールを使わせたいとき”エージェントは、ふだんは jira を使い、MCP ツールは jira にできないことにだけ使います。
MCP ツールを優先させたいときは、⚙設定 →「エージェントへの指示」 に書いておきます。
Jira は
jiraCLI ではなく Atlassian MCP ツールを使うこと。
コネクタを持つエージェントはこれに従い、持たないエージェントは jira を使い続けます。
MCP のコネクタはエージェントごとに用意が要り、ログインが切れるとセッションの再起動が要ります。
ターミナルからも同じように使えます。
jira issue list -p PROJjira issue view PROJ-1 --comments 5jira initでトークンを聞かれることはありません--debugを付けた実行には、接続を使いません（デバッグの出力に認証の情報が出てしまうためです）
「the Jira connection is unusable」と出る
Section titled “「the Jira connection is unusable」と出る”接続の期限が切れたか、取り消されています。⚙設定 →「課題管理」 で Jira をつなぎ直してください。
課題を作ったら終了コード 3 で終わった
Section titled “課題を作ったら終了コード 3 で終わった”課題はできていて、説明文だけが設定できていません。もう一度作らないでください。
説明文は jira issue edit PROJ-1 --no-input -b "…" で設定し直します。
issue edit -b が終了コード 3 で終わったときも同じで、ほかの変更は反映済みです。
書き込みが終了コード 124 で終わった
Section titled “書き込みが終了コード 124 で終わった”Jira から応答がなく、打ち切られました。端末のない実行（エージェントの実行など）では、書き込みは約 2 分で打ち切られます。課題やコメントができている可能性があるので、Jira を確かめてから実行し直してください。
issue createのときは、直近 15 分に同じ件名で作った課題が「possible matches」として出ます- 読み取りのコマンドは、通信が切れたときに自動で最大 2 回やり直します。書き込みはやり直しません
「this config has no issue types」と出る
Section titled “「this config has no issue types」と出る”jira issue create に要るプロジェクトの課題タイプを、jira が取得できていません。一緒に出るヒントのとおりに jira init を実行してください。
担当者を指定するとプロジェクトを聞かれる
Section titled “担当者を指定するとプロジェクトを聞かれる”担当者を探すには、プロジェクトが要ります。-p PROJ を付けるか、jira init --project PROJ --board "PROJ board" を実行してください。
jira issue assign PROJ-1 <ユーザー> は、課題キーからプロジェクトを補います。
ボード・スプリント・エピックが認可のエラーになる
Section titled “ボード・スプリント・エピックが認可のエラーになる”OAuth の接続に Jira Software のスコープがありません。上の注意のとおり、テナント管理者に頼んでください。
このときは、jira が表示するリンクもサイトではなく api.atlassian.com を指します。
Jira Data Center を使う
Section titled “Jira Data Center を使う”設定画面からは接続できません。自分の --server を付けた jira init、自分で用意した設定ファイル、または JIRA_API_TOKEN で設定してください。
そのときの jira は、保存済みの接続を使わず、あなたの設定どおりに動きます。
- 課題管理サービスを接続する：Jira の接続と、左ペインの一覧
- Confluence を使う：同じ接続で Confluence のページを扱う