mcpField
P
pp-jira

pp-jira

github.com/mvanhorn生産性2.1k77 回インストール今日更新
リポジトリ

pp-jira について

pp-jira は、幅広いコマンドで Jira Cloud を操作する Printing Press CLI スキルです。課題、プロジェクト、設定、管理機能を扱います。README には Jira API コマンドが記載されていますが、MCP インターフェースについての説明はありません。

主な機能

  1. 01Jira アプリケーション設定の管理
  2. 02課題の一括操作
  3. 03プロジェクトコンポーネントの作成と更新
  4. 04添付ファイルとメタデータの取得

活用シーン

  1. 01Jira 課題の一括編集やステータス遷移
  2. 02Jira の監査記録の確認
  3. 03プロジェクトコンポーネントの設定
  4. 04課題の添付ファイル内容の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-jira

インストール後、Claude Code で/pp-jiraを入力して読み込まれたか確認します。

詳細

Jira Cloud Platform — Printing Press CLI

前提条件：CLI のインストール

このスキルは jira-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。 インストールされていない場合は、最初にインストールしてください。

  1. Printing Press インストーラーを使ってインストールします。デフォルトでは、macOS/Linux では $HOME/.local/bin に、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリが配置されます。 
    npx -y @mvanhorn/printing-press-library install jira --cli-only
  2. 確認します：jira-pp-cli --version
  3. このスキルを実行するエージェント／ランタイムの $PATH に、表示されたインストールディレクトリが含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go による直接インストールに切り替えてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/project-management/jira/cmd/jira-pp-cli@latest

インストール後に --version が「command not found」と表示される場合、ランタイムからバイナリディレクトリを $PATH 経由で参照できていません。確認が成功するまで、このスキルのコマンドを実行しないでください。

コマンドリファレンス

announcement-banner — このリソースは告知バナーを表します。バナーの設定を取得および更新するために使用します。

  • jira-pp-cli announcement-banner get-banner — 現在の告知バナー設定を返します。権限 が必要です： Jira の管理...
  • jira-pp-cli announcement-banner set-banner — 告知バナー設定を更新します。権限 が必要です： Jira の管理 [グローバル...

app — アプリを管理

  • jira-pp-cli app get-custom-field-configuration — カスタムフィールドの設定一覧をページ分割形式で返します...
  • jira-pp-cli app get-custom-fields-configurations — カスタムフィールドの設定一覧をページ分割形式で返します...
  • jira-pp-cli app update-custom-field-configuration — カスタムフィールドのコンテキスト設定を更新します。[タイプ](https://developer.atlassian.com/platform/forge/ma...
  • jira-pp-cli app update-custom-field-value — 1 件以上の課題にあるカスタムフィールドの値を更新します。アプリがこの操作を実行できるのは、[カスタム...
  • jira-pp-cli app update-multiple-custom-field-values — 1 件以上の課題にある 1 個以上のカスタムフィールドの値を更新します。カスタムフィールドと課題の組み合わせは...

application-properties — アプリケーションプロパティを管理

  • jira-pp-cli application-properties get-advanced-settings — 詳細設定ページで参照できるアプリケーションプロパティを返します。詳細設定に移動するには...
  • jira-pp-cli application-properties get-application-property — すべてのアプリケーションプロパティ、または特定のアプリケーションプロパティを返します。key パラメーターに値を指定すると...
  • jira-pp-cli application-properties set-application-property — アプリケーションプロパティの値を変更します。たとえば、jira.clone.prefix の値を変更できます...

applicationrole — アプリケーションロールを管理

  • jira-pp-cli applicationrole get-all-application-roles — すべてのアプリケーションロールを返します。Jira では、アプリケーションロールは[アプリケーションアクセス...
  • jira-pp-cli applicationrole get-application-role — アプリケーションロールを返します。権限 が必要です： Jira の管理 [グローバル...

atlassian-connect — Atlassian Connect を管理

  • jira-pp-cli atlassian-connect addon-properties-resource-delete-addon-property-delete — アプリのプロパティを削除します。必要な権限： addonKey とキーが一致する Connect アプリのみ...
  • jira-pp-cli atlassian-connect addon-properties-resource-get-addon-properties-get — アプリのすべてのプロパティを取得します。予約済みキー connect_client_key_019cdff3-8bfb-71fe-9628-875b700aebb8 は...
  • jira-pp-cli atlassian-connect addon-properties-resource-get-addon-property-get — アプリのプロパティのキーと値を返します。プロパティキー...
  • jira-pp-cli atlassian-connect addon-properties-resource-put-addon-property-put — アプリのプロパティの値を設定します。このリソースを使用して、アプリのカスタムデータを保存します。リクエストの値...
  • jira-pp-cli atlassian-connect app-issue-field-value-update-resource-update-issue-fields-put — 1 件以上の課題に追加された Connect アプリのカスタムフィールドの値を更新します。最大 200 件のカスタム...
  • jira-pp-cli atlassian-connect connect-to-forge-migration-fetch-task-resource-fetch-migration-task-get — Connect の課題フィールドから Forge への移行の詳細を返します。Connect アプリを Forge に移行する際は、[課題...
  • jira-pp-cli atlassian-connect connect-to-forge-migration-task-submission-resource-submit-task-post — Connect の課題フィールドを、対応する Forge カスタムフィールドに移行するリクエストを送信します。移行する際は...
  • jira-pp-cli atlassian-connect dynamic-modules-resource-get-modules-get — 呼び出し元のアプリによって動的に登録されたすべてのモジュールを返します。必要な権限： のみ...
  • jira-pp-cli atlassian-connect dynamic-modules-resource-register-modules-post — モジュールのリストを登録します。必要な権限： このリクエストを実行できるのは Connect アプリのみです。
  • jira-pp-cli atlassian-connect dynamic-modules-resource-remove-modules-delete — 呼び出し元のアプリによって登録されたすべてのモジュール、または指定したモジュールを削除します。必要な権限： のみ...
  • jira-pp-cli atlassian-connect migration-resource-update-entity-properties-value-put — オブジェクトの複数のエンティティプロパティの値を更新します。1 回のリクエストで最大 50 件まで更新できます。この操作は...
  • jira-pp-cli atlassian-connect migration-resource-workflow-rule-search-post — サーバーからクラウドに移行され、呼び出し元の Connect アプリが所有するワークフロートランジションルールの設定を返します。
  • jira-pp-cli atlassian-connect service-registry-resource-services-get — 指定されたサービスレジストリの属性を取得します。必要な権限： このリクエストを実行できるのは Connect アプリのみです...

添付ファイル — 添付ファイルを管理

  • jira-pp-cli attachment get — 添付ファイルのメタデータを返します。添付ファイル自体は返されません。この操作は...
  • jira-pp-cli attachment get-content — 添付ファイルの内容を返します。Range ヘッダーを設定して、添付ファイル内のバイト範囲を指定できます...
  • jira-pp-cli attachment get-meta — 添付ファイルの設定、つまり添付ファイルが有効かどうか、および許可される添付ファイルの最大サイズを返します...
  • jira-pp-cli attachment get-thumbnail — 添付ファイルのサムネイルを返します。添付ファイルの内容を返すには、[添付ファイルを取得...
  • jira-pp-cli attachment remove — 課題から添付ファイルを削除します。この操作は匿名で実行できます。**権限...

監査 — 監査を管理

  • jira-pp-cli auditing — 監査レコードの一覧を返します。次の条件を含めるように一覧をフィルタリングできます：* filter 内の各項目が...

アバター — このリソースはシステムアバターとカスタムアバターを表します。システムアバターまたはカスタムアバターの詳細を取得したり、プロジェクト、課題タイプ、優先度にアバターを追加・削除したり、アバター画像を取得したりできます。

一括処理 — 一括処理を管理

  • jira-pp-cli bulk get-available-transitions — 指定した課題で利用可能なトランジションの一覧を取得します。この一覧は、利用または一括...
  • jira-pp-cli bulk get-editable-fields — 一括編集操作を行う際にユーザーに表示されるフィールドの一覧を取得します。単一または複数の...
  • jira-pp-cli bulk get-operation-progress — 指定した一括操作 taskId の進行状況を取得します。**Permissions...
  • jira-pp-cli bulk submit-delete — 一括削除リクエストを送信します。1 回の操作で最大 1,000 件の課題を削除できます....
  • jira-pp-cli bulk submit-edit — 一括編集リクエストを送信し、複数の課題を同時に編集します。適用される制限...
  • jira-pp-cli bulk submit-move — 一括課題移動リクエストを送信します。1 回の操作で複数のプロジェクトから複数の課題を移動できます...
  • jira-pp-cli bulk submit-transition — 一括課題ステータストランジションリクエストを送信します。複数の課題をトランジションでき、さらに...
  • jira-pp-cli bulk submit-unwatch — 一括ウォッチ解除リクエストを送信します。1 回の操作で最大 1,000 件の課題のウォッチを解除できます....
  • jira-pp-cli bulk submit-watch — 一括ウォッチリクエストを送信します。1 回の操作で最大 1,000 件の課題をウォッチできます....

changelog — 変更履歴を管理

  • jira-pp-cli changelog — 複数の課題の変更履歴を一括取得し、フィールドで絞り込みます。指定したすべての課題の変更履歴をページ分割された一覧で返します...

classification-levels — このリソースは分類レベルを表します。

  • jira-pp-cli classification-levels — すべての分類レベルを返します。Permissions required: なし。

comment — コメントを管理

  • jira-pp-cli comment — コメント ID のリストで指定されたコメントのページ分割された一覧を返します。この操作は...

component — コンポーネントを管理

  • jira-pp-cli component create — コンポーネントを作成します。コンポーネントを使用して、プロジェクト内の課題をまとめるコンテナーを提供します。コンポーネントを使用して...
  • jira-pp-cli component delete — コンポーネントを削除します。この操作は匿名でも実行できます。Permissions required:...
  • jira-pp-cli component find-for-projects — プロジェクト内のすべてのコンポーネントのページ分割された一覧を返します。対象には、次の場合はグローバル（Compass）コンポーネントも含まれます...
  • jira-pp-cli component get — コンポーネントを返します。この操作は匿名でも実行できます。Permissions required: *Browse...
  • jira-pp-cli component update — コンポーネントを更新します。リクエストに含まれるフィールドは上書きされます。leadAccountId が空文字列（''）の場合...

config — 設定を管理

  • jira-pp-cli config associate-projects-to-field-association-schemes — プロジェクトをフィールド関連付けスキームに関連付けます。権限 が必要です： Jira の管理 [グローバル...
  • jira-pp-cli config clone-field-association-scheme — 既存のフィールド関連付けスキームを新しいスキームに複製するエンドポイントです。権限 が必要です：...
  • jira-pp-cli config create-field-association-scheme — 新しいフィールド関連付けスキームを作成するエンドポイントです。権限 が必要です： Jira の管理...
  • jira-pp-cli config delete-field-association-scheme — 指定したフィールド関連付けスキームを削除します。権限 が必要です： Jira の管理 [グローバル...
  • jira-pp-cli config get-field-association-scheme-by-id — ID を指定してフィールド関連付けスキームを取得するエンドポイントです。権限 が必要です： Jira の管理...
  • jira-pp-cli config get-field-association-scheme-item-parameters — フィールド関連付けスキームのフィールド関連付けパラメーターを取得します。権限 が必要です：...
  • jira-pp-cli config get-field-association-schemes — 任意のフィルタリングを使用して、フィールド関連付けスキームのページ分割された一覧を取得する REST エンドポイントです。このエンドポイント...
  • jira-pp-cli config get-projects-with-field-schemes — フィールド関連付けスキームが設定されたプロジェクトを取得します。一時的な API ですが、移行時に役立ちます...
  • jira-pp-cli config remove-field-association-scheme-item-parameters — 作業タイプのフィールド関連付けパラメーターのオーバーライドを削除します。権限 が必要です： Jira の管理...
  • jira-pp-cli config remove-fields-associated-with-schemes — フィールド関連付けスキームに関連付けられたフィールドを削除します。権限 が必要です： Jira の管理...
  • jira-pp-cli config search-field-association-scheme-fields — 指定したフィールド関連付けスキームに属するフィールドを検索します。権限 が必要です：...
  • jira-pp-cli config search-field-association-scheme-projects — 指定したフィールド関連付けスキームに属するプロジェクトを検索する REST エンドポイントです。権限 が必要です：...
  • jira-pp-cli config update-field-association-scheme — 既存のフィールド関連付けスキームを更新するエンドポイントです。権限 が必要です： Jira の管理...
  • jira-pp-cli config update-field-association-scheme-item-parameters — フィールド関連付けスキームの項目パラメーターを更新します。権限 が必要です：...
  • jira-pp-cli config update-fields-associated-with-schemes — フィールド関連付けスキームに関連付けられたフィールドを更新します。権限 が必要です： Jira の管理...

configuration — 設定を管理

  • jira-pp-cli configuration get — Jira のグローバル設定を返します。これらの設定によって、...
  • jira-pp-cli configuration get-available-time-tracking-implementations — すべての時間管理プロバイダーを返します。デフォルトでは、Jira には時間管理プロバイダーが 1 つだけあります：*JIRA 提供の時間...
  • jira-pp-cli configuration get-selected-time-tracking-implementation — 現在選択されている時間管理プロバイダーを返します。時間管理が無効になっている場合は、...
  • jira-pp-cli configuration get-shared-time-tracking — 時間管理設定を返します。時間形式、デフォルトの時間単位などの設定が含まれます。...
  • jira-pp-cli configuration select-time-tracking-implementation — 時間管理プロバイダーを選択します。権限 が必要です： Jira の管理 [グローバル...
  • jira-pp-cli configuration set-shared-time-tracking — 時間管理設定を設定します。権限 が必要です： Jira の管理 [グローバル...

custom-field-option — カスタムフィールドオプションを管理

  • jira-pp-cli custom-field-option <id> — カスタムフィールドオプションを返します。たとえば、選択リストのオプションです。この操作は**次の場合にのみ機能します... dashboard — ダッシュボードを表します。ダッシュボードの詳細を取得したり、ダッシュボードから項目のプロパティやガジェットを取得、作成、更新、削除したりするために使用します。

  • jira-pp-cli dashboard bulk-edit — ダッシュボードを一括編集します。同時に編集できるダッシュボードの最大数は 100 件です。…

  • jira-pp-cli dashboard create — ダッシュボードを作成します。必要な権限： なし。

  • jira-pp-cli dashboard delete — ダッシュボードを削除します。必要な権限： なし。削除するダッシュボードは、…によって所有されている必要があります。

  • jira-pp-cli dashboard get — ダッシュボードを返します。この操作は匿名で実行できます。必要な権限： なし。…

  • jira-pp-cli dashboard get-all — ユーザーが所有または共有されているダッシュボードの一覧を返します。お気に入りのみ、または…のみを含めるよう一覧を絞り込めます。

  • jira-pp-cli dashboard get-all-available-gadgets — すべてのダッシュボードに追加できる、利用可能なすべてのガジェットの一覧を取得します。必要な権限：…

  • jira-pp-cli dashboard get-paginated — ページ分割されたダッシュボードの一覧を返します。この操作は [Get… と同様です。

  • jira-pp-cli dashboard update — ダッシュボードを更新し、ダッシュボードの詳細を指定された内容ですべて置き換えます。必要な権限：…

data-policy — データポリシーを管理します

  • jira-pp-cli data-policy get-policies — リクエストで指定されたプロジェクトのデータポリシーを返します。
  • jira-pp-cli data-policy get-policy — ワークスペースのデータポリシーを返します。

events — イベントを管理します

  • jira-pp-cli events — すべての課題イベントを返します。必要な権限： Jira の管理 [グローバル…

expression — 式を管理します

  • jira-pp-cli expression analyse — Jira 式を分析し、検証します。実験的機能として、この操作では型チェックも試行できます…
  • jira-pp-cli expression evaluate-jira — エンドポイントは現在廃止中です。詳細…
  • jira-pp-cli expression evaluate-jsisjira — Jira 式を評価し、その値を返します。eval との違いは、このエンドポイントが…を使用することです。

field — フィールドを管理します

  • jira-pp-cli field create-associations — フィールドをプロジェクトに関連付けます。指定されたプロジェクトの各課題タイプにフィールドが関連付けられます。フィールド…
  • jira-pp-cli field create-custom — カスタムフィールドを作成します。必要な権限： Jira の管理 [グローバル…
  • jira-pp-cli field delete-custom — カスタムフィールドを削除します。カスタムフィールドは、ゴミ箱にあるかどうかにかかわらず削除されます。[カスタムフィールドの編集または削除…]を参照してください。
  • jira-pp-cli field get — 次のルールに従って、システムおよびカスタムの課題フィールドを返します。* 課題に追加できないフィールド…
  • jira-pp-cli field get-paginated — Classic Jira プロジェクトのフィールドのページ分割された一覧を返します。一覧には次の内容を含められます。* すべてのフィールド *…
  • jira-pp-cli field get-trashed-paginated — ゴミ箱内のフィールドのページ分割された一覧を返します。フィールドの…に該当するフィールドに一覧を絞り込めます。
  • jira-pp-cli field remove-associations — 一連のフィールドとプロジェクトおよび課題タイプのコンテキストとの関連付けを解除します。すべての…との関連付けが解除されます。
  • jira-pp-cli field update-custom — カスタムフィールドを更新します。必要な権限： Jira の管理 [グローバル…

fieldconfiguration — fieldconfiguration を管理します

fieldconfigurationscheme — fieldconfigurationscheme を管理します

filter — このリソースはフィルターを表します。フィルターの取得、作成、更新、削除に使用します。また、フィルターの列を設定したり、お気に入りのフィルターを設定したりする際にも使用します。

  • jira-pp-cli filter create — フィルターを作成します。フィルターはデフォルトの共有範囲に従って共有されます。...
  • jira-pp-cli filter delete — フィルターを削除します。権限が必要です： Jira にアクセスする権限。ただし、フィルターは...
  • jira-pp-cli filter get — フィルターを返します。この操作は匿名で実行できます。権限が必要です： なし、...
  • jira-pp-cli filter get-default-share-scope — ユーザーの新しいフィルターおよびダッシュボードのデフォルト共有設定を返します。**権限...
  • jira-pp-cli filter get-favourite — ユーザーに表示されているお気に入りのフィルターを返します。この操作は匿名で実行できます。...
  • jira-pp-cli filter get-my — ユーザーが所有するフィルターを返します。includeFavourites が true の場合、ユーザーに表示されているお気に入りのフィルターも...
  • jira-pp-cli filter get-paginated — フィルターのページ分割されたリストを返します。この操作を使用して、次のものを取得します：* id を指定した特定のフィルター...
  • jira-pp-cli filter set-default-share-scope — ユーザーの新しいフィルターおよびダッシュボードのデフォルト共有範囲を設定します。権限が必要です：...
  • jira-pp-cli filter update — フィルターを更新します。この操作を使用して、フィルターの名前、説明、JQL、または共有設定を更新します。...

forge — forge を管理します

  • jira-pp-cli forge bulk-pin-unpin-projects-async — Forge アプリが追加した課題パネルを、複数のプロジェクトに一括でピン留めまたはピン留め解除します。この操作は実行されます...
  • jira-pp-cli forge delete-app-property — Forge アプリのプロパティを削除します。Permissions required: このリクエストを実行できるのは Forge アプリのみです....
  • jira-pp-cli forge get-app-property — Forge アプリのプロパティの値を返します。Permissions required: このリクエストを実行できるのは Forge アプリのみです...
  • jira-pp-cli forge get-app-property-keys — Forge アプリのすべてのプロパティキーを返します。Permissions required: このリクエストを実行できるのは Forge アプリのみです...
  • jira-pp-cli forge put-app-property — Forge アプリのプロパティの値を設定します。これらの値は [Jira...

group — このリソースはユーザーのグループを表します。グループの取得、作成、検索、削除、およびグループへのユーザーの追加と削除に使用します。([WARNING] Atlassian の標準グループ名はデフォルトの名前にすぎず、編集または削除できます。たとえば、管理者または Atlassian サポートは、デフォルトグループ jira-software-users をいつでも削除したり、jsw-users に名前を変更したりできます。詳細については https://support.atlassian.com/user-management/docs/create-and-update-groups/ を参照してください。)

  • jira-pp-cli group add-user-to — ユーザーをグループに追加します。Permissions required: サイト管理者（つまり、...
  • jira-pp-cli group bulk-get — グループのページネーションされたリストを返します。Permissions required: *ユーザーの参照と...
  • jira-pp-cli group create — グループを作成します。Permissions required: サイト管理者（つまり、site-admin...
  • jira-pp-cli group get — この操作は非推奨です。代わりに group/member を使用してください。グループ内のすべてのユーザーを返します....
  • jira-pp-cli group get-users-from — グループ内のすべてのユーザーのページネーションされたリストを返します。ユーザーはユーザー名順に並べられますが...
  • jira-pp-cli group remove — グループを削除します。Permissions required: サイト管理者（つまり、site-admin...
  • jira-pp-cli group remove-user-from — グループからユーザーを削除します。Permissions required: サイト管理者（つまり、...

groups — このリソースはユーザーのグループを表します。グループの取得、作成、検索、削除、およびグループへのユーザーの追加と削除に使用します。([WARNING] Atlassian の標準グループ名はデフォルトの名前にすぎず、編集または削除できます。たとえば、管理者または Atlassian サポートは、デフォルトグループ jira-software-users をいつでも削除したり、jsw-users に名前を変更したりできます。詳細については https://support.atlassian.com/user-management/docs/create-and-update-groups/ を参照してください。)

  • jira-pp-cli groups — 名前に検索文字列を含むグループのリストを返します。除外するグループ名のリストを指定できます...

groupuserpicker — groupuserpicker を管理します

  • jira-pp-cli groupuserpicker — 文字列に一致するユーザーとグループのリストを返します。この文字列は次の目的で使用されます：* ユーザーの場合、大文字と小文字を区別せずに検索します...

instance — インスタンスを管理します

  • jira-pp-cli instance — Jira インスタンスのライセンス情報を返します。Permissions required: なし。

internal — 内部機能を管理します

  • jira-pp-cli internal — 課題 ID と作業ログ ID のペアのリストについて、作業ログの詳細を返します。これは一括取得のための内部 API です...

issue — このリソースは Jira の課題を表します。以下に使用します：

  • 課題を個別または一括で作成、編集します。
  • 課題の作成または編集で使用できるオプションのメタデータを取得します。
  • 課題を削除します。
  • 課題にユーザーを割り当てます。
  • 課題の変更履歴を取得します。
  • 課題に関する通知を送信します。
  • 課題で利用可能なトランジションの詳細を取得します。
  • 課題をトランジションします。
  • 課題をアーカイブします。
  • 課題をアーカイブ解除します。
  • アーカイブ済みの課題をエクスポートします。
  • jira-pp-cli issue archive — 管理者が課題 ID/キーを使用して、1 回のリクエストで最大 1000 件の課題をアーカイブできるようにします。詳細を返します...
  • jira-pp-cli issue archive-async — 管理者が JQL を使用して、1 回のリクエストで最大 100,000 件の課題を非同期でアーカイブできるようにします。ステータスを確認するための URL を返します...
  • jira-pp-cli issue bulk-delete-property — 複数の課題からプロパティ値を削除します。更新する課題はフィルター条件で指定できます。...
  • jira-pp-cli issue bulk-fetch — 要求された一連の課題の詳細を返します。最大 100 件の課題を要求できます。各課題はその...によって識別されます。
  • jira-pp-cli issue bulk-set-properties-by — 課題のエンティティプロパティ値を設定または更新します。各課題に対して最大 10 個のエンティティプロパティを指定でき、...
  • jira-pp-cli issue bulk-set-properties-list — 課題のエンティティプロパティ値のリストを設定または更新します。最大 10 個のエンティティプロパティのリストを指定でき...
  • jira-pp-cli issue bulk-set-property — 複数の課題にプロパティ値を設定します。設定する値は定数、または [Jira... によって決定できます。
  • jira-pp-cli issue create — 課題を作成します。または、Jira でサブタスクを作成するオプションが有効になっている場合はサブタスクを作成します。トランジションが適用される場合があります...
  • jira-pp-cli issue create-bulk — 最大 50 件の課題を作成し、Jira でサブタスクを作成するオプションが有効になっている場合はサブタスクも作成します。トランジションが適用される場合があります...
  • jira-pp-cli issue delete — 課題を削除します。1 つ以上のサブタスクがある課題は削除できません。サブタスクのある課題を削除するには、...を設定します。
  • jira-pp-cli issue edit — 課題を編集します。編集の一環として課題プロパティを更新できます。課題のトランジションは...ではないことに注意してください。
  • jira-pp-cli issue get — 課題の詳細を返します。課題はその ID またはキーによって識別されますが、識別子が一致しない場合は...
  • jira-pp-cli issue get-create-meta — プロジェクト、プロジェクト内の課題タイプ、および要求された場合は各...の作成画面フィールドの詳細を返します。
  • jira-pp-cli issue get-create-meta-type-id — 指定されたプロジェクトと課題タイプ ID のフィールドメタデータのページを返します。この情報を使用して...を設定します。
  • jira-pp-cli issue get-create-meta-types — 指定されたプロジェクトの課題タイプメタデータのページを返します。この情報を使用して [...
  • jira-pp-cli issue get-is-watching-bulk — ユーザーに対して、リスト内の課題のウォッチステータスの詳細を返します。課題 ID が無効な場合、返される...
  • jira-pp-cli issue get-limit-report — 課題ごとの制限に違反している、または近づいているすべての課題を返します。権限が必要: * *Browse...
  • jira-pp-cli issue get-picker-resource — クエリ文字列に一致する課題のリストを返します。このリソースを使用して、...の際に自動補完候補を提供します。
  • jira-pp-cli issue unarchive — 管理者が課題 ID/キーを使用して、1 回のリクエストで最大 1000 件の課題をアーカイブ解除できるようにします。詳細を返します...

issue-link — このリソースは課題間のリンクを表します。これを使用して、課題間のリンクを取得、作成、削除します。

これを使用するには、サイトで課題リンクが有効になっている必要があります。

  • jira-pp-cli issue-link delete — 課題リンクを削除します。この操作は匿名でアクセスできます。権限が必要: *...
  • jira-pp-cli issue-link get — 課題リンクを返します。この操作は匿名でアクセスできます。権限が必要: *...
  • jira-pp-cli issue-link link-issues — 2 つの課題間のリンクを作成します。この操作を使用して、2 つの課題間の関係を示し、必要に応じて...

issue-link-type — このリソースは課題リンクタイプを表します。これを使用して、リンク課題タイプの取得、作成、更新、削除、およびすべてのリンク課題タイプのリストの取得を行います。

これを使用するには、サイトで課題リンクが有効になっている必要があります。

  • jira-pp-cli issue-link-type create — 課題リンクタイプを作成します。この操作は、課題をリンクする理由の説明を作成するために使用します。...
  • jira-pp-cli issue-link-type delete — 課題リンクタイプを削除します。この操作を使用するには、サイトで[課題...
  • jira-pp-cli issue-link-type get — すべての課題リンクタイプの一覧を返します。この操作を使用するには、サイトで[課題...
  • jira-pp-cli issue-link-type get-issuelinktype — 課題リンクタイプを返します。この操作を使用するには、サイトで[課題...
  • jira-pp-cli issue-link-type update — 課題リンクタイプを更新します。この操作を使用するには、サイトで[課題...

issues — このリソースは Jira の課題を表します。次の操作に使用します。

  • 課題を個別または一括で作成、編集します。
  • 課題の作成または編集に使用できるオプションのメタデータを取得します。
  • 課題を削除します。
  • ユーザーを課題に割り当てます。
  • 課題の変更履歴を取得します。
  • 課題に関する通知を送信します。
  • 課題で利用可能なトランジションの詳細を取得します。
  • 課題をトランジションします。
  • 課題をアーカイブします。
  • 課題のアーカイブを解除します。
  • アーカイブ済みの課題をエクスポートします。
  • jira-pp-cli issues — 管理者がアーカイブ済みのすべての課題の詳細を取得できるようにします。リクエストが成功すると、リクエストを送信した管理者は...

issuesecurityschemes — 課題セキュリティスキームを管理します

  • jira-pp-cli issuesecurityschemes associate-schemes-to-projects — 課題セキュリティスキームをプロジェクトに関連付け、必要に応じて課題のセキュリティレベルを新しいレベルに再マッピングします...
  • jira-pp-cli issuesecurityschemes create-issue-security-scheme — セキュリティスキームと、そのレベルおよびレベルのメンバーを作成します。最大100個のセキュリティスキームを作成できます...
  • jira-pp-cli issuesecurityschemes delete-security-scheme — 課題セキュリティスキームを削除します。必要な権限： Jira の管理 [グローバル...
  • jira-pp-cli issuesecurityschemes get-issue-security-scheme — 課題セキュリティスキームとそのセキュリティレベルを返します。必要な権限： *...
  • jira-pp-cli issuesecurityschemes get-issue-security-schemes — すべての課題セキュリティスキームを返します。**必要な権限...
  • jira-pp-cli issuesecurityschemes get-security-level-members — ページネーションされた課題セキュリティレベルのメンバー一覧を返します。対象は、...
  • jira-pp-cli issuesecurityschemes get-security-levels — ページネーションされた課題セキュリティレベルの一覧を返します。対象は、...
  • jira-pp-cli issuesecurityschemes search-projects-using-security-schemes — セキュリティスキームを使用しているプロジェクトのページネーションされたマッピングを返します。いずれか1つを指定できます...
  • jira-pp-cli issuesecurityschemes search-security-schemes — 課題セキュリティスキームのページネーションされた一覧を返します。プロジェクト ID パラメーターを指定すると、...
  • jira-pp-cli issuesecurityschemes set-default-levels — スキームのデフォルトの課題セキュリティレベルを設定します。必要な権限： Jira の管理 [グローバル...
  • jira-pp-cli issuesecurityschemes update-issue-security-scheme — 課題セキュリティスキームを更新します。必要な権限： Jira の管理 [グローバル...

issuetype — 課題タイプを管理します

  • jira-pp-cli issuetype create-issue-type — 課題タイプを作成します。権限 が必要です： Jira の管理 [グローバル...
  • jira-pp-cli issuetype delete-issue-type — 課題タイプを削除します。課題タイプが使用中の場合、すべての使用箇所が代替の課題タイプに更新されます...
  • jira-pp-cli issuetype get-issue-all-types — すべての課題タイプを返します。この操作は匿名でアクセスできます。権限 が必要です： 課題...
  • jira-pp-cli issuetype get-issue-type — 課題タイプを返します。この操作は匿名でアクセスできます。権限 が必要です： *参照...
  • jira-pp-cli issuetype get-issue-types-for-project — プロジェクトの課題タイプを返します。この操作は匿名でアクセスできます。**権限...
  • jira-pp-cli issuetype update-issue-type — 課題タイプを更新します。権限 が必要です： Jira の管理 [グローバル...

issuetypescheme — 課題タイプスキームを管理

  • jira-pp-cli issuetypescheme assign-issue-type-scheme-to-project — 課題タイプスキームをプロジェクトに割り当てます。プロジェクト内の課題に、スキームに含まれていない課題タイプが割り当てられている場合...
  • jira-pp-cli issuetypescheme create-issue-type-scheme — 課題タイプスキームを作成します。権限 が必要です： Jira の管理 [グローバル...
  • jira-pp-cli issuetypescheme delete-issue-type-scheme — 課題タイプスキームを削除します。クラシックプロジェクトで使用されている課題タイプスキームのみ削除できます。課題タイプ...
  • jira-pp-cli issuetypescheme get-all-issue-type-schemes — 課題タイプスキームのページ分割されたリストを返します。クラシックプロジェクトで使用されている課題タイプスキームのみ...
  • jira-pp-cli issuetypescheme get-issue-type-scheme-for-projects — 課題タイプスキームのページ分割されたリストを返します。また、各課題タイプスキームについて、...
  • jira-pp-cli issuetypescheme get-issue-type-schemes-mapping — 課題タイプスキーム項目のページ分割されたリストを返します。クラシック...
  • jira-pp-cli issuetypescheme update-issue-type-scheme — 課題タイプスキームを更新します。権限 が必要です： Jira の管理 [グローバル...

issuetypescreenscheme — 課題タイプ画面スキームを管理

  • jira-pp-cli issuetypescreenscheme assign-issue-type-screen-scheme-to-project — 課題タイプ画面スキームをプロジェクトに割り当てます。課題タイプ画面スキームはクラシック...
  • jira-pp-cli issuetypescreenscheme create-issue-type-screen-scheme — 課題タイプ画面スキームを作成します。権限 が必要です： Jira の管理 [グローバル...
  • jira-pp-cli issuetypescreenscheme delete-issue-type-screen-scheme — 課題タイプ画面スキームを削除します。権限 が必要です： Jira の管理 [グローバル...
  • jira-pp-cli issuetypescreenscheme get-issue-type-screen-scheme-mappings — 課題タイプ画面スキーム項目のページ分割されたリストを返します。クラシック...
  • jira-pp-cli issuetypescreenscheme get-issue-type-screen-scheme-project-associations — 課題タイプ画面スキームのページ分割されたリストを返します。また、各課題タイプ画面スキームについて、リスト...
  • jira-pp-cli issuetypescreenscheme get-issue-type-screen-schemes — 課題タイプ画面スキームのページ分割されたリストを返します。クラシック...
  • jira-pp-cli issuetypescreenscheme update-issue-type-screen-scheme — 課題タイプ画面スキームを更新します。権限 が必要です： Jira の管理 [グローバル...

jira-search — Jira Cloud プラットフォームの検索を管理

  • jira-pp-cli jira-search and-reconsile-issues-using-jql — JQL を使用して課題を検索します。最近の更新がすぐに反映されない場合があります...
  • jira-pp-cli jira-search and-reconsile-issues-using-jql-post — JQL を使用して課題を検索します。最近の更新がすぐに反映されない場合があります...
  • jira-pp-cli jira-search count-issues — JQL に一致する課題のおおよその件数を提供します。最近の...
  • jira-pp-cli jira-search for-issues-using-jql — このエンドポイントは現在削除されつつあります。詳細 検索...
  • jira-pp-cli jira-search for-issues-using-jql-post — このエンドポイントは現在削除されつつあります。詳細 検索...

jira-version — Jira Cloud プラットフォームのバージョンを管理します

  • jira-pp-cli jira-version create — プロジェクトバージョンを作成します。この操作は匿名でアクセスできます。必要な権限:...
  • jira-pp-cli jira-version delete — プロジェクトバージョンを削除します。非推奨です。[削除と置換...
  • jira-pp-cli jira-version get — プロジェクトバージョンを返します。この操作は匿名でアクセスできます。必要な権限:...
  • jira-pp-cli jira-version update — プロジェクトバージョンを更新します。この操作は匿名でアクセスできます。必要な権限:...

jira-workflow — Jira Cloud プラットフォームのワークフローを管理します

  • jira-pp-cli jira-workflow create-transition-property — これは 2026年6月1日 に削除されます;...
  • jira-pp-cli jira-workflow delete-inactive — ワークフローを削除します。次の場合、ワークフローは削除できません: * アクティブなワークフロー。 * システムワークフロー。 * 関連付け...
  • jira-pp-cli jira-workflow delete-transition-property — これは 2026年6月1日 に削除されます;...
  • jira-pp-cli jira-workflow delete-transition-rule-configurations — 1つ以上のワークフローからワークフロートランジションルールを削除します。次のルールタイプがサポートされています: * [post...
  • jira-pp-cli jira-workflow get-paginated — これは 2026年6月1日 に削除されます;...
  • jira-pp-cli jira-workflow get-transition-properties — これは 2026年6月1日 に削除されます;...
  • jira-pp-cli jira-workflow get-transition-rule-configurations — トランジションルールを持つワークフローのページネーションされたリストを返します。ワークフローは、返す対象をフィルタリングできます...
  • jira-pp-cli jira-workflow list-history — 指定されたワークフロー ID のワークフロー履歴エントリのリストを返します。注意: 保存されたワークフローデータは次の期間後に期限切れになります...
  • jira-pp-cli jira-workflow read-from-history — 指定されたワークフロー ID とバージョン番号のワークフローおよび関連するステータスを返します。注意: 保存されたワークフロー...
  • jira-pp-cli jira-workflow update-transition-property — これは 2026年6月1日 に削除されます;...
  • jira-pp-cli jira-workflow update-transition-rule-configurations — ワークフロートランジションルールの設定を更新します。次のルールタイプがサポートされています: * [post...

jql — このリソースは JQL 検索のオートコンプリートの詳細を表します。これを使用して、クエリのプログラムによる構築やカスタムクエリビルダーで使用する JQL 検索のオートコンプリートデータと候補を取得できます。また、次の操作も提供します:

  • ユーザー識別子 (ユーザー名またはユーザーキー) を含む1つ以上の JQL クエリを、アカウント ID を含む同等の JQL クエリに変換します。
  • ユーザーが詳細を閲覧できるエンティティを閲覧する権限を持たない場合に、1つ以上の JQL クエリ内の読み取り可能な詳細を ID に変換します。
  • jira-pp-cli jql get-auto-complete — JQL 検索用の参照データを返します。Advanced... で提供されているドキュメントのダウンロード版です。
  • jira-pp-cli jql get-auto-complete-post — JQL 検索用の参照データを返します。Advanced... で提供されているドキュメントのダウンロード版です。
  • jira-pp-cli jql get-field-auto-complete-for-query-string — フィールドに対する JQL 検索のオートコンプリート候補を返します。候補は次の情報を指定して取得できます：*...
  • jira-pp-cli jql get-precomputations — 関数の事前計算の一覧と、作成日時、更新日時、および...
  • jira-pp-cli jql get-precomputations-by-id — ID で関数の事前計算を返します。作成日時、更新日時、最終更新日時などの情報も含まれます...
  • jira-pp-cli jql match-issues — 1 つ以上の課題が、1 つ以上の JQL クエリで返されるかどうかを確認します。**権限...
  • jira-pp-cli jql migrate-queries — ユーザー識別子（ユーザー名またはユーザーキー）を含む 1 つ以上の JQL クエリを、アカウントを含む同等の JQL クエリに変換します...
  • jira-pp-cli jql parse-queries — JQL クエリを解析して検証します。検証は現在のユーザーのコンテキストで実行されます。この操作は...
  • jira-pp-cli jql sanitise-queries — ユーザーに権限がない場合に、読み取り可能な詳細を ID に変換して、1 つ以上の JQL クエリをサニタイズします...
  • jira-pp-cli jql update-precomputations — Forge／Connect アプリによって作成された関数の事前計算値を更新します。**権限...

ラベル — このリソースは利用可能なラベルを表します。グローバルラベルフィールドで利用可能なラベルを取得するために使用します。

ライセンス — ライセンスを管理します

  • jira-pp-cli license get-approximate-application-count — 1 つの Jira ライセンスに含まれるユーザーアカウントのおおよその合計数を返します。この情報は...
  • jira-pp-cli license get-approximate-count — すべての Jira ライセンスに含まれるユーザーアカウントのおおよその数を返します。この情報はキャッシュされます...

自分の権限 — 自分の権限を管理します

  • jira-pp-cli mypermissions — ユーザーが持つ権限を示す権限の一覧を返します。ユーザーの権限の詳細は...

自分の設定 — 自分の設定を管理します

  • jira-pp-cli mypreferences get-locale — ユーザーのロケールを返します。ユーザーが言語設定を指定していない場合（これはデフォルト設定です）、またはこの...
  • jira-pp-cli mypreferences get-preference — 現在のユーザーの設定値を返します。次のキーは非推奨です：* jira.user.locale ...
  • jira-pp-cli mypreferences remove-preference — ユーザーの設定を削除し、システム定義の設定のデフォルト値に戻します。これらのキーは...
  • jira-pp-cli mypreferences set-locale — 非推奨です。[ユーザープロファイルを更新](https://developer.atlassian.com/cloud/admin/user-management/rest/#api-users-...
  • jira-pp-cli mypreferences set-preference — プレーンテキスト文字列を送信して、ユーザーの設定を作成するか、設定値を更新します。たとえば...

自分自身 — このリソースは、基本情報、グループメンバーシップ、アプリケーションロール、設定、ロケールなど、現在のユーザーに関する情報を表します。ユーザーの設定とロケールの値の取得、作成、更新、および削除（デフォルトへの復元）に使用します。

  • jira-pp-cli myself — 現在のユーザーの詳細を返します。必要な権限： Jira へのアクセス権限。

通知スキーム — 通知スキームを管理します

  • jira-pp-cli notificationscheme create-notification-scheme — 通知を含む通知スキームを作成します。1 リクエストにつき最大 1000 件の通知を作成できます。...
  • jira-pp-cli notificationscheme delete-notification-scheme — 通知スキームを削除します。必要な権限： Jira の管理 [グローバル...
  • jira-pp-cli notificationscheme get-notification-scheme — イベントの一覧と...を含む通知スキームを返します。
  • jira-pp-cli notificationscheme get-notification-scheme-to-project-mappings — 通知スキームが割り当てられているプロジェクトのページネーションされたマッピングを返します。いずれかを指定できます...
  • jira-pp-cli notificationscheme get-notification-schemes — 通知スキームのページネーションされた一覧を、...順に返します。
  • jira-pp-cli notificationscheme update-notification-scheme — 通知スキームを更新します。必要な権限： Jira の管理 [グローバル...

権限 — このリソースは権限を表します。すべての権限の詳細を取得し、ユーザーが特定の権限を持っているかどうかを確認するために使用します。

  • jira-pp-cli permissions get-all — 以下を含むすべての権限を返します：* グローバル権限。* プロジェクト権限。* ...によって追加されたグローバル権限。
  • jira-pp-cli permissions get-bulk — 以下を返します：* グローバル権限のリストに対して、ユーザーに付与されたグローバル権限。* プロジェクト...のリストに対して...
  • jira-pp-cli permissions get-permitted-projects — ユーザーにプロジェクト権限のリストが付与されているすべてのプロジェクトを返します。この操作には...からアクセスできます。

権限スキーム — 権限スキームを管理します

  • jira-pp-cli permissionscheme create-permission-scheme — 新しい権限スキームを作成します。権限のセットを定義する場合もしない場合も、権限スキームを作成できます...
  • jira-pp-cli permissionscheme delete-permission-scheme — 権限スキームを削除します。必要な権限： Jira の管理 [グローバル...
  • jira-pp-cli permissionscheme get-all-permission-schemes — すべての権限スキームを返します。### 権限スキームと付与について ### 権限スキームは...のコレクションです。
  • jira-pp-cli permissionscheme get-permission-scheme — 権限スキームを返します。必要な権限： Jira へのアクセス権限。
  • jira-pp-cli permissionscheme update-permission-scheme — 権限スキームを更新します。このリソースを使用する際の重要な注意事項を以下に示します：* 権限...の場合...

プラン — このリソースはプランを表します。プランの取得、作成、複製、更新、ゴミ箱への移動、アーカイブに使用します。

  • jira-pp-cli plans add-atlassian-team — 既存の Atlassian チームをプランに追加し、計画設定を構成します。**権限...
  • jira-pp-cli plans archive — プランをアーカイブします。必要な権限： Administer Jira [global...
  • jira-pp-cli plans create — プランを作成します。必要な権限： Administer Jira [global...
  • jira-pp-cli plans create-only-team — プラン専用チームを作成し、計画設定を構成します。必要な権限：...
  • jira-pp-cli plans delete-only-team — プラン専用チームとその計画設定を削除します。必要な権限： Administer Jira...
  • jira-pp-cli plans duplicate — プランを複製します。必要な権限： Administer Jira [global...
  • jira-pp-cli plans get — プランのページ分割された一覧を返します。必要な権限： Administer Jira...
  • jira-pp-cli plans get-atlassian-team — プラン内の Atlassian チームの計画設定を返します。必要な権限： *Administer...
  • jira-pp-cli plans get-only-team — プラン専用チームの計画設定を返します。必要な権限： Administer Jira [global...
  • jira-pp-cli plans get-plan — プランを返します。必要な権限： Administer Jira [global...
  • jira-pp-cli plans get-teams — プラン内のプラン専用チームと Atlassian チームのページ分割された一覧を返します。**必要な権限...
  • jira-pp-cli plans remove-atlassian-team — Atlassian チームをプランから削除し、その計画設定を削除します。必要な権限：...
  • jira-pp-cli plans trash — プランをごみ箱に移動します。必要な権限： Administer Jira [global...
  • jira-pp-cli plans update — JSON Patch を使用して、プランの次の詳細のいずれかを更新します。*...
  • jira-pp-cli plans update-atlassian-team — [JSON...
  • jira-pp-cli plans update-only-team — [JSON...

priority — 優先度を管理

  • jira-pp-cli priority create — 課題の優先度を作成します。リクエストボディの iconUrl パラメーターは廃止予定で、3 月 16 日...
  • jira-pp-cli priority delete — 課題の優先度を削除します。この操作は非同期です。レスポンス内の location リンクをたどって...
  • jira-pp-cli priority get — 課題の優先度を返します。必要な権限： Jira へのアクセス権限。
  • jira-pp-cli priority get-priorities — すべての課題の優先度一覧を返します。必要な権限： Jira へのアクセス権限。
  • jira-pp-cli priority move-priorities — 課題の優先度の順序を変更します。必要な権限： Administer Jira [global...
  • jira-pp-cli priority search-priorities — 優先度のページ分割された一覧を返します。一覧にはすべての優先度、または...で指定された一部を含めることができます。
  • jira-pp-cli priority set-default — 課題のデフォルトの優先度を設定します。必要な権限： Administer Jira [global...
  • jira-pp-cli priority update — 課題の優先度を更新します。リクエストボディのパラメーターを少なくとも 1 つ定義する必要があります。iconUrl パラメーターは廃止予定で...

priorityscheme — 優先度スキームを管理

  • jira-pp-cli priorityscheme create-priority-scheme — 新しい優先度スキームを作成します。Permissions required: Administer Jira [global...
  • jira-pp-cli priorityscheme delete-priority-scheme — 優先度スキームを削除します。この操作は、関連付けられたプロジェクトがない優先度スキームでのみ利用できます。...
  • jira-pp-cli priorityscheme get-available-priorities-by-priority-scheme — 優先度スキームに追加できる優先度のページネーションされたリストを返します。...
  • jira-pp-cli priorityscheme get-priority-schemes — 優先度スキームのページネーションされたリストを返します。Permissions required: 次への権限...
  • jira-pp-cli priorityscheme suggested-priorities-for-mappings — 優先度の変更または...を考慮した場合に、マッピングが必要となる優先度のページネーションされたリストを返します。
  • jira-pp-cli priorityscheme update-priority-scheme — 優先度スキームを更新します。これには、その詳細、およびその中の優先度とプロジェクトのリストが含まれます。...

project — このリソースはプロジェクトを表します。これを使用して、プロジェクトの取得、作成、更新、削除を行います。また、プロジェクトで利用可能なステータス、プロジェクトの通知スキームを取得し、プロジェクトのタイプを更新します。

  • jira-pp-cli project create — 次の表に示すプロジェクトタイプテンプレートに基づいてプロジェクトを作成します。 | Project Type Key | Project...
  • jira-pp-cli project delete — プロジェクトを削除します。アーカイブされたプロジェクトは削除できません。アーカイブされたプロジェクトを削除するには、プロジェクトを復元して...
  • jira-pp-cli project get — プロジェクトのプロジェクト詳細を返します。この操作は...
  • jira-pp-cli project get-accessible-type-by-key — プロジェクトタイプがユーザーがアクセス可能な場合にそれを返します。...
  • jira-pp-cli project get-all — ユーザーに表示されるすべてのプロジェクトを返します。非推奨です。[ Get projects...
  • jira-pp-cli project get-all-accessible-types — 有効なライセンスを持つすべてのプロジェクトタイプを返します。
  • jira-pp-cli project get-all-types — インスタンスが有効な...であるかどうかに関係なく、すべてのプロジェクトタイプを返します。
  • jira-pp-cli project get-recent — ユーザーが最近表示した、まだユーザーに表示される最大20件のプロジェクトのリストを返します。この操作は...
  • jira-pp-cli project get-type-by-key — プロジェクトタイプを返します。この操作は匿名でアクセスできます。...
  • jira-pp-cli project search — ユーザーに表示されるプロジェクトのページネーションされたリストを返します。この操作は匿名でアクセスできます。...
  • jira-pp-cli project update — プロジェクトのプロジェクト詳細を更新します。すべてのパラメータはオプションです。...

project-category — プロジェクトカテゴリを管理します

  • jira-pp-cli project-category create — プロジェクトカテゴリを作成します。Permissions required: Administer Jira [global...
  • jira-pp-cli project-category get-all-project-categories — すべてのプロジェクトカテゴリを返します。Permissions required: Jira へのアクセス権限。
  • jira-pp-cli project-category get-by-id — プロジェクトカテゴリを返します。Permissions required: Jira へのアクセス権限。
  • jira-pp-cli project-category remove — プロジェクトカテゴリを削除します。Permissions required: Administer Jira [global...
  • jira-pp-cli project-category update — プロジェクトカテゴリを更新します。Permissions required: Administer Jira [global...

project-template — このリソースはプロジェクトテンプレートを表します。これを使用して、カスタムテンプレートから新しいプロジェクトを作成します。

  • jira-pp-cli project-template create-project-with-custom-template — リクエストで指定されたカスタムテンプレートに基づいてプロジェクトを作成します。リクエスト本文にはプロジェクトを含める必要があります...
  • jira-pp-cli project-template edit-template — カスタムテンプレートを編集します。この API エンドポイントでは、既存のカスタマイズされたテンプレートを編集できます。***注: カスタムテンプレートは...
  • jira-pp-cli project-template live-template — カスタムテンプレートを取得します。この API エンドポイントでは、templateKey のいずれかを使用して、ライブのカスタムプロジェクトテンプレートの詳細を取得できます...
  • jira-pp-cli project-template remove-template — カスタムテンプレートを削除します。この API エンドポイントでは、指定したカスタマイズされたテンプレートを削除できます ***注: カスタムテンプレートは...
  • jira-pp-cli project-template save-template — カスタムテンプレートを保存します。この API エンドポイントでは、カスタマイズされたテンプレートを保存できます ***注: カスタムテンプレートは...

projects — このリソースはプロジェクトを表します。これを使用して、プロジェクトの取得、作成、更新、削除を行います。また、プロジェクトで利用可能なステータス、プロジェクトの通知スキームを取得し、プロジェクトのタイプを更新します。

  • jira-pp-cli projects — 要求されたプロジェクトと作業タイプのフィールドのページネーションされたリストを返します。対象となるのは...

projectvalidate — projectvalidate を管理します

  • jira-pp-cli projectvalidate get-valid-project-key — プロジェクトキーを検証し、キーが無効または使用中の場合、プロジェクトキー用の有効なランダム文字列を生成します...
  • jira-pp-cli projectvalidate get-valid-project-name — プロジェクト名が使用されていないことを確認します。名前が使用されていない場合、渡された文字列が返されます。名前が使用中の場合は...
  • jira-pp-cli projectvalidate validate-project-key — キーが有効な文字列であり、使用されていないことを確認してプロジェクトキーを検証します。**権限...

redact — redact を管理します

  • jira-pp-cli redact get-redaction-status — 墨消しジョブ ID の現在のステータスを取得します。jobStatus は次のいずれかになります: * IN_PROGRESS - ...
  • jira-pp-cli redact redact — 課題フィールドデータを墨消しするジョブを送信します。これにより、指定されたフィールドのデータの墨消しが開始されます...

resolution — resolution を管理します

  • jira-pp-cli resolution create — 課題の解決状況を作成します。権限が必要: Jira の管理 [グローバル...
  • jira-pp-cli resolution delete — 課題の解決状況を削除します。この操作は非同期です。応答内の location リンクをたどって...
  • jira-pp-cli resolution get — すべての課題解決状況の値のリストを返します。権限が必要: Jira へのアクセス権。
  • jira-pp-cli resolution get-id — 課題の解決状況の値を返します。権限が必要: Jira へのアクセス権。
  • jira-pp-cli resolution move — 課題の解決状況の順序を変更します。権限が必要: Jira の管理 [グローバル...
  • jira-pp-cli resolution search — 解決状況のページネーションされたリストを返します。リストにはすべての解決状況、または... によって決定されたサブセットを含めることができます。
  • jira-pp-cli resolution set-default — デフォルトの課題解決状況を設定します。権限が必要: Jira の管理 [グローバル...
  • jira-pp-cli resolution update — 課題の解決状況を更新します。権限が必要: Jira の管理 [グローバル...

role — role を管理します

  • jira-pp-cli role create-project — デフォルトアクターを持たない新しいプロジェクトロールを作成します。[デフォルトの追加...]を使用できます。
  • jira-pp-cli role delete-project — プロジェクトロールを削除します。使用中のプロジェクトロールを削除する場合は、代替のプロジェクトロールを指定する必要があります...
  • jira-pp-cli role fully-update-project — プロジェクトロールの名前と説明を更新します。リクエストには名前と説明の両方を含める必要があります...
  • jira-pp-cli role get-all-project — プロジェクトロールの詳細とデフォルトアクターを含む、すべてのプロジェクトロールのリストを取得します。### プロジェクトロールについて ###...
  • jira-pp-cli role get-project-by-id — プロジェクトロールの詳細と、そのロールに関連付けられたデフォルトアクターを取得します。デフォルトアクターのリストは次の順序で並べ替えられます...
  • jira-pp-cli role partial-update-project — プロジェクトロールの名前または説明のいずれかを更新します。名前と説明の両方を同時に更新することはできません...

screens — このリソースは、課題の詳細を記録するために使用される画面を表します。次の目的で使用します:

  • すべての画面の詳細を取得します。
  • 画面で使用できるすべてのフィールドの詳細を取得します。
  • 画面を作成します。
  • 画面を削除します。
  • 画面を更新します。
  • デフォルト画面にフィールドを追加します。
  • jira-pp-cli screens add-field-to-default — デフォルト画面のデフォルトタブにフィールドを追加します。権限が必要: Jira の管理...
  • jira-pp-cli screens create — デフォルトのフィールドタブを持つ画面を作成します。権限が必要: Jira の管理 [グローバル...
  • jira-pp-cli screens delete — 画面を削除します。画面が画面スキーム、ワークフロー、またはワークフロードラフトで使用されている場合は削除できません。次の場合のみ...
  • jira-pp-cli screens get — すべての画面、または1つ以上の画面 ID で指定された画面のページネーションされたリストを返します。...
  • jira-pp-cli screens get-bulk-tabs — 複数の画面のタブのリストを返します。権限が必要: * Jira の管理...
  • jira-pp-cli screens update — 画面を更新します。クラシックプロジェクトで使用されている画面のみ更新できます。権限が必要:...

screenscheme — 画面スキームを管理します

  • jira-pp-cli screenscheme create-screen-scheme — 画面スキームを作成します。権限が必要: Jira の管理 [グローバル...
  • jira-pp-cli screenscheme delete-screen-scheme — 画面スキームを削除します。画面スキームが課題タイプ画面スキームで使用されている場合は削除できません。次の場合のみ...
  • jira-pp-cli screenscheme get-screen-schemes — 画面スキームのページネーションされたリストを返します。クラシックプロジェクトで使用されている画面スキームのみが...
  • jira-pp-cli screenscheme update-screen-scheme — 画面スキームを更新します。クラシックプロジェクトで使用されている画面スキームのみ更新できます。**権限...

securitylevel — セキュリティレベルを管理します

  • jira-pp-cli securitylevel <id> — 課題セキュリティレベルの詳細を返します。[課題セキュリティの取得...]を使用してください。

server-info — このリソースは、Jira インスタンスに関する情報を提供します。

  • jira-pp-cli server-info — Jira インスタンスに関する情報を返します。この操作は匿名でアクセスできます。...

settings — 設定を管理します

  • jira-pp-cli settings get-issue-navigator-default-columns — デフォルトの課題ナビゲーターの列を返します。権限が必要: Jira の管理 [グローバル...
  • jira-pp-cli settings set-issue-navigator-default-columns — デフォルトの課題ナビゲーターの列を設定します。columns パラメーターはナビゲート可能なフィールド値を受け入れ、次のように表現されます...

status — このリソースはステータスを表します。ステータスの検索、取得、作成、削除、および変更に使用します。

  • jira-pp-cli status get — ステータスを返します。ステータスが返されるには、アクティブなワークフローに関連付けられている必要があります。名前が複数の...

  • jira-pp-cli status get-statuses — アクティブなワークフローに関連付けられたすべてのステータスのリストを返します。この操作は匿名でアクセスできます。... statuscategory — ステータスカテゴリーを管理します

  • jira-pp-cli statuscategory get-status-categories — すべてのステータスカテゴリーの一覧を返します。権限 が必要です： Jira へのアクセス権限。

  • jira-pp-cli statuscategory get-status-category — ステータスカテゴリーを返します。ステータスカテゴリーは、分類するための仕組みを提供します...

statuses — ステータスを管理します

  • jira-pp-cli statuses create — グローバルまたはプロジェクトのスコープでステータスを作成します。権限 が必要です： * プロジェクトの管理...
  • jira-pp-cli statuses delete-by-id — ID を指定してステータスを削除します。権限 が必要です： * プロジェクトの管理 [プロジェクト...
  • jira-pp-cli statuses get-by-id — 1 つ以上のステータス ID で指定されたステータスの一覧を返します。権限 が必要です： *...
  • jira-pp-cli statuses get-by-name — 1 つ以上のステータス名で指定されたステータスの一覧を返します。権限 が必要です： *...
  • jira-pp-cli statuses search — ページネーションされたステータスの一覧を返します...
  • jira-pp-cli statuses update — ID を指定してステータスを更新します。権限 が必要です： * プロジェクトの管理 [プロジェクト...

task — このリソースは、長時間実行される非同期タスクを表します。長時間実行されるタスクの進行状況の詳細を取得したり、タスクをキャンセルしたりする際に使用します。

ui-modifications — UI の変更を管理します

  • jira-pp-cli ui-modifications create — UI の変更を作成します。UI の変更を作成できるのは Forge アプリのみです。各アプリは最大 3000 件の UI...
  • jira-pp-cli ui-modifications delete — UI の変更を削除します。その UI の変更に属するすべてのコンテキストも削除されます。UI の変更は...
  • jira-pp-cli ui-modifications get — UI の変更を取得します。UI の変更を取得できるのは Forge アプリのみです。**権限...
  • jira-pp-cli ui-modifications update — UI の変更を更新します。UI の変更を更新できるのは Forge アプリのみです。各 UI の変更では最大...

universal-avatar — ユニバーサルアバターを管理します

  • jira-pp-cli universal-avatar delete-avatar — プロジェクト、課題タイプ、または優先度からアバターを削除します。権限 が必要です： *管理者...
  • jira-pp-cli universal-avatar get-avatar-image-by-id — ID で指定されたプロジェクト、課題タイプ、または優先度のアバター画像を返します。この操作は匿名でアクセスできます...
  • jira-pp-cli universal-avatar get-avatar-image-by-owner — プロジェクト、課題タイプ、または優先度のアバター画像を返します。この操作は匿名でアクセスできます...
  • jira-pp-cli universal-avatar get-avatar-image-by-type — デフォルトのプロジェクト、課題タイプ、または優先度のアバター画像を返します。この操作は匿名でアクセスできます...
  • jira-pp-cli universal-avatar get-avatars — プロジェクト、課題タイプ、または優先度のシステムアバターとカスタムアバターを返します。この操作はアクセスできます...
  • jira-pp-cli universal-avatar store-avatar — プロジェクト、課題タイプ、または優先度のカスタムアバターを読み込みます。リクエスト本文でアバターのローカルファイルの場所を指定します...

user — このリソースはユーザーを表します。以下に使用します。

  • ユーザーの取得、一覧取得、作成、削除。
  • ユーザーのデフォルトの課題テーブル列の取得、設定、リセット。
  • ユーザーが所属するグループの一覧取得。
  • ユーザー名またはユーザーキーの一覧に対応するユーザーアカウント ID の一覧取得。
  • jira-pp-cli user bulk-get — 1つ以上のアカウント ID で指定されたユーザーのページ分割された一覧を返します。
  • jira-pp-cli user bulk-get-migration — key または username パラメーターで指定されたユーザーのアカウント ID を返します。複数の key または...
  • jira-pp-cli user create — ユーザーを作成します。このリソースはレガシー互換性のために保持されています。より適切な代替手段が...
  • jira-pp-cli user delete-property — ユーザーのプロパティを削除します。注：この操作は[user...
  • jira-pp-cli user find — 検索文字列とプロパティに一致するアクティブユーザーの一覧を返します。この操作ではまず、フィルターを適用して...
  • jira-pp-cli user find-assignable — 課題に割り当て可能なユーザーの一覧を返します。この操作を使うと、割り当て可能なユーザーの一覧を...
  • jira-pp-cli user find-bulk-assignable — 1つ以上のプロジェクトで課題を割り当て可能なユーザーの一覧を返します。ユーザーの一覧は制限される場合があります...
  • jira-pp-cli user find-by-query — 構造化クエリでユーザーを検索し、ユーザー詳細のページ分割された一覧を返します。この操作...
  • jira-pp-cli user find-for-picker — 属性がクエリ用語に一致するユーザーの一覧を返します。返されるオブジェクトには html フィールドが含まれ、...
  • jira-pp-cli user find-keys-by-query — 構造化クエリでユーザーを検索し、ユーザーキーのページ分割された一覧を返します。この操作では...
  • jira-pp-cli user find-with-all-permissions — 次の条件を満たすユーザーの一覧を返します。* ユーザー属性が検索文字列に一致する。* 一連の...
  • jira-pp-cli user find-with-browse-permission — 次の条件を満たすユーザーの一覧を返します。* ユーザー属性が検索文字列に一致する。* ユーザーに...
  • jira-pp-cli user get — ユーザーを返します。ユーザーの設定に基づいて、応答にはプライバシー制御が適用されます。たとえば、...
  • jira-pp-cli user get-default-columns — ユーザーの既定の課題テーブルの列を返します。accountId が...
  • jira-pp-cli user get-email — ユーザーのプロフィール公開設定にかかわらず、ユーザーのメールアドレスを返します。Connect アプリの場合、この API は...
  • jira-pp-cli user get-email-bulk — ユーザーのプロフィール公開設定にかかわらず、ユーザーのメールアドレスを返します。Connect アプリの場合、この API は...
  • jira-pp-cli user get-groups — ユーザーが所属するグループを返します。必要な権限： ユーザーとグループの参照...
  • jira-pp-cli user get-property — ユーザーのプロパティ値を返します。プロパティキーが指定されていない場合は、[Get user property...
  • jira-pp-cli user get-property-keys — ユーザーのすべてのプロパティのキーを返します。注：この操作は[user...
  • jira-pp-cli user remove — ユーザーを削除します。操作が正常に完了すると、ユーザーは Jira のユーザーベースから削除されます。この...
  • jira-pp-cli user reset-columns — ユーザーの既定の課題テーブルの列をシステム...
  • jira-pp-cli user set-columns — ユーザーの既定の課題テーブルの列を設定します。アカウント ID が...
  • jira-pp-cli user set-property — ユーザーのプロパティ値を設定します。このリソースを使って、ユーザーにカスタムデータを保存できます。注：この操作...

users — このリソースはユーザーを表します。次の操作に使用します。

  • ユーザーの取得、一覧表示、作成、削除。
  • ユーザーの既定の課題テーブルの列の取得、設定、リセット。
  • ユーザーが所属するグループの一覧表示。
  • ユーザー名またはユーザーキーの一覧に対応するユーザーアカウント ID の一覧表示。
  • jira-pp-cli users get-all — すべてのユーザーのリストを返します。これには、アクティブユーザー、非アクティブユーザー、および以前に削除されたユーザーで、...
  • jira-pp-cli users get-all-default — すべてのユーザーのリストを返します。これには、アクティブユーザー、非アクティブユーザー、および以前に削除されたユーザーで、...

webhook — このリソースは webhook を表します。Webhook は、JQL クエリで指定された課題について Jira でイベントが発生したときに URL に送信される呼び出しです。Webhook を登録および管理できるのは、Connect アプリと OAuth 2.0 アプリのみです。詳細については、Webhooks を参照してください。

  • jira-pp-cli webhook delete-by-id — ID を指定して webhook を削除します。呼び出し元のアプリによって登録された webhook のみが削除されます。他のアプリによって作成された webhook は...
  • jira-pp-cli webhook get-dynamic-for-app — 呼び出し元のアプリによって登録された webhook のページネーションされたリストを返します。**権限...
  • jira-pp-cli webhook get-failed — 最大回数を超えた後、要求元のアプリへの配信に最近失敗した webhook を返します...
  • jira-pp-cli webhook refresh — webhook の有効期間を延長します。REST API を通じて登録された webhook は 30 日後に期限切れになります。この操作を呼び出して...
  • jira-pp-cli webhook register-dynamic — webhook を登録します。注意: 非公開の OAuth アプリの場合、webhook は一致するものがある場合にのみ配信されます...

workflows — このリソースはワークフローを表します。次の目的で使用します:

  • ワークフローの取得
  • ワークフローの作成
  • ワークフローの更新
  • 非アクティブなワークフローの削除
  • ワークフロー機能の取得
  • jira-pp-cli workflows capabilities — ワークフロー ID、またはプロジェクトと課題を指定して、特定のワークフローのワークフロー機能のリストを取得します...
  • jira-pp-cli workflows create — ワークフローと関連するステータスを作成します。権限が必要: * Jira の管理 プロジェクト...
  • jira-pp-cli workflows get-default-editor — ユーザーのデフォルトのワークフローエディターを取得します。これは新しいエディターまたはレガシーエディターのいずれかになります。
  • jira-pp-cli workflows read — ワークフロー名、ワークフロー ID、またはプロジェクトと課題を指定して、ワークフローと関連するステータスのリストを返します...
  • jira-pp-cli workflows read-previews — 指定されたプロジェクト内の要求されたワークフローを返します。レスポンスはワークフローの読み取り専用プレビューを提供し...
  • jira-pp-cli workflows search — グローバルおよびプロジェクトのワークフローのページネーションされたリストを返します。ワークフロー名が...で指定されている場合
  • jira-pp-cli workflows update — ワークフローと関連するステータスを更新します。権限が必要: * Jira の管理 プロジェクト...
  • jira-pp-cli workflows validate-create — ワークフローの一括作成のためのペイロードを検証します。権限が必要: * Jira の管理...
  • jira-pp-cli workflows validate-update — ワークフローの一括更新のためのペイロードを検証します。権限が必要: * Jira の管理...

workflowscheme — workflowscheme を管理します

  • jira-pp-cli workflowscheme assign-scheme-to-project — プロジェクトにワークフロースキームを割り当てます。この操作は、プロジェクトに課題がない場合にのみ実行されます。…
  • jira-pp-cli workflowscheme create-workflow-scheme — ワークフロースキームを作成します。必要な権限： Jira の管理 [グローバル…
  • jira-pp-cli workflowscheme delete-workflow-scheme — ワークフロースキームを削除します。ワークフロースキームがアクティブな場合（つまり、使用中の場合）は削除できません。…
  • jira-pp-cli workflowscheme get-all-workflow-schemes — 下書きのワークフロースキームを除く、すべてのワークフロースキームのページ分割された一覧を返します。…
  • jira-pp-cli workflowscheme get-required-workflow-scheme-mappings — ワークフロースキームに加える変更に必要なステータスマッピングを取得します。結果は課題ごとに返されます。…
  • jira-pp-cli workflowscheme get-workflow-scheme — ワークフロースキームを返します。必要な権限： Jira の管理 [グローバル…
  • jira-pp-cli workflowscheme get-workflow-scheme-project-associations — プロジェクトの一覧に関連付けられたワークフロースキームの一覧を返します。返される各ワークフロースキームには…
  • jira-pp-cli workflowscheme read-workflow-schemes — ワークフロースキーム ID またはプロジェクト ID を指定して、ワークフロースキームの一覧を返します。**権限…
  • jira-pp-cli workflowscheme switch-workflow-scheme-for-project — プロジェクトのワークフロースキームを切り替えます。ワークフロースキームを割り当てられるのは、クラシックプロジェクトのみです。**計算…
  • jira-pp-cli workflowscheme update-schemes — 企業管理対象プロジェクトとチーム管理対象プロジェクトのワークフロースキームを更新します。この API には下書きの概念がないため、…
  • jira-pp-cli workflowscheme update-workflow-scheme — 企業管理対象プロジェクトのワークフロースキームを更新します。名前、デフォルトのワークフロー、課題タイプからプロジェクトへの…

worklog — 作業ログを管理します

  • jira-pp-cli worklog get-for-ids — 作業ログ ID の一覧について、作業ログの詳細を返します。返される作業ログの一覧は 1000 件に制限されています。…
  • jira-pp-cli worklog get-ids-of-deleted-since — 指定した日時以降に削除された作業ログの ID と削除タイムスタンプの一覧を返します。このリソースはページ分割されます。…
  • jira-pp-cli worklog get-ids-of-modified-since — 指定した日時以降に更新された作業ログの ID と更新タイムスタンプの一覧を返します。このリソースはページ分割されます。…
適切なコマンドを見つける

実行したいことはわかっているものの、どのコマンドを使えばよいかわからない場合は、CLI に直接問い合わせてください。

jira-pp-cli which "<capability in your own words>"

which は、自然言語で記述された機能に関する問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも 1 件一致したことを示します。終了コード 2 は確信を持てる一致がないことを示します。その場合は --help を使うか、より対象を絞った問い合わせに切り替えてください。

認証の設定

jira-pp-cli auth setup を実行すると、トークンを取得するための URL と手順が表示されます（URL を開くには --launch を追加します）。次に、トークンを保存します。

jira-pp-cli auth set-token YOUR_TOKEN_HERE

または、環境変数として JIRA_OAUTH2 を設定します。

jira-pp-cli doctor を実行して、設定を確認します。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

  • パイプ対応 — stdout に JSON を出力し、エラーは stderr に出力します

  • フィルター対応 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素を順に処理します。コンテキストを小さく保つうえで、詳細な API では特に重要です。

    jira-pp-cli attachment get mock-value --agent --select id,name,status

  • プレビュー対応 — --dry-run を使うと、リクエストを送信せずに内容を表示します

  • オフラインでも利用可能 — 同期／検索コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます

  • 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

  • 明示的な再試行 — すでに存在するものの作成を成功として扱う場合にのみ --idempotent を使用し、削除対象が存在しない場合を成功として扱う場合にのみ --ignore-missing を使用してください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力をプロベナンスエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を、ライブかローカルかを判別するには .meta.source を解析してください。人間が読める N results (live) の概要は、stdout が端末の場合にのみ stderr に出力されます。パイプやエージェントで利用する場合、stdout には純粋な JSON のみが出力されます。

エージェントからのフィードバック

この CLI について気になる点に気づいたら（エージェントが気づいた場合も）、記録してください。

jira-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
jira-pp-cli feedback --stdin < notes.txt
jira-pp-cli feedback list --json --limit 10

エントリーは ~/.jira-pp-cli/feedback.jsonl にローカル保存されます。JIRA_FEEDBACK_ENDPOINT が設定され、さらに --send が渡されるか JIRA_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトの動作はローカル保存のみです。

バグ報告ではなく、意外に感じたことを書いてください。短く、具体的に、1 行で記録します。それが積み重なっていきます。

出力の配信

すべてのコマンドは --deliver <sink> を受け付けます。出力は stdout に加えて（または stdout の代わりに）指定したシンクに送られるため、エージェントはコマンド結果を手作業でパイプ処理せずに振り分けられます。サポートされているシンクは 3 種類です。

シンク動作
stdoutデフォルト。stdout のみに書き込みます
file:<path>出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>出力本文を URL に POST します（--compact の場合、application/json または application/x-ndjson）

不明なスキームは、サポートされているスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを stderr に記録します。

名前付きプロファイル

プロファイルは、保存されたフラグ値のセットで、複数回の実行で再利用できます。スケジュールされたエージェントが毎回同じ設定で同じコマンドを呼び出す場合に使用します。HeyGen の「Beacon」パターンがその例です。

jira-pp-cli profile save briefing --json
jira-pp-cli --profile briefing attachment get mock-value
jira-pp-cli profile list --json
jira-pp-cli profile show briefing
jira-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイル値より優先され、プロファイル値はデフォルトより優先されます。agent-context は available_profiles の下にすべてのプロファイルを一覧表示するため、情報を調査するエージェントは実行時にそれらを見つけられます。

非同期ジョブ

時間のかかる処理を送信するエンドポイントでは、ジェネレーターが送信後にポーリングするパターン（レスポンス内に job_id／task_id／operation_id フィールドがあり、対応するステータスエンドポイントがある場合）を検出し、送信コマンドに 3 つの追加フラグを設定します。

フラグ用途
--waitジョブ ID をすぐに返す代わりに、ジョブが終端ステータスに達するまで待機します
--wait-timeout最大待機時間（デフォルトは 10m、0 はタイムアウトなし）
--wait-interval初回のポーリング間隔（デフォルトは 2s。指数バックオフで最大 30s まで延長します）

非同期で送信して処理を任せる場合は --wait を付けずに使用し、1 つのコマンドで完成した成果物を返したい場合は --wait を使用してください。

終了コード

コード意味
0成功
2使用方法のエラー（引数が正しくありません）
3リソースが見つかりません
4認証が必要です
5API エラー（上流の問題）
7レート制限中（待機して再試行してください）
10設定エラー

引数の解析

$ARGUMENTS を解析します。

  1. 空、help、または --help → jira-pp-cli --help の出力を表示します
  2. install で始まる場合 → mcp で終わる場合は MCP のインストール。それ以外の場合は、上記の「前提条件」を参照してください
  3. それ以外 → 直接使用（--agent を付けて CLI コマンドを実行します）

MCP サーバーのインストール

この CLI の公開ライブラリーエントリーまたはビルド済みリリースから MCP バイナリーをインストールし、登録します。

claude mcp add jira-pp-mcp -- jira-pp-mcp

確認します：claude mcp list

直接使用

  1. インストール済みか確認します：which jira-pp-cli 見つからない場合は、インストールを提案してください（このスキルの冒頭にある「前提条件」を参照）。
  2. ユーザーのクエリに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
  3. --agent フラグを付けて実行します。 
    jira-pp-cli <command> [subcommand] [args] --agent
  4. 曖昧な場合は、サブコマンドのヘルプを確認します：jira-pp-cli <command> --help。

コメント

Markdown 対応