acli

Atlassian CLI (acli) リファレンス

前提条件

このスキルを使用するには、acli がインストールされ、認証済みである必要があります。このスキルにはバイナリは同梱されていません。

acli がインストールされていない場合は、ユーザーに次のページを案内してください：https://developer.atlassian.com/cloud/acli/guides/install-acli/

利用可能かどうかを確認します：

acli --help

認証

コマンドを実行する前に、認証状態を確認します：

acli jira auth status
acli admin auth status

認証されていない場合、次の3つの方法があります：

OAuth（対話型、ユーザーに推奨）：

acli jira auth login --web

API トークン（非対話型、CI／自動化に推奨）：

echo "$API_TOKEN" | acli jira auth login --site "mysite.atlassian.net" --email "[email protected]" --token

Admin API Key（管理者コマンド専用）：

echo "$API_KEY" | acli admin auth login --email "[email protected]" --token

アカウントを切り替えます：

acli jira auth switch --site mysite.atlassian.net --email [email protected]
acli admin auth switch --org myorgname

セキュリティ

シークレットの取り扱い

• **コマンドにトークンや API キーをハードコードしないでください。**必ず環境変数（$API_TOKEN、$API_KEY）またはファイル入力（< token.txt）を使用してください。
• **出力にトークンを記録、エコー、表示しないでください。**ディスク上に残る中間ファイルを経由してシークレットをパイプすることは避けてください。
• **対話型の使用では OAuth（--web）を優先してください。**トークンベースの認証は、OAuth が利用できない CI／自動化の場合にのみ使用してください。
• トークンをシェルの履歴に保存しないでください。echo "$API_TOKEN" | acli ... を使用する場合、変数にリテラル値を直接指定せず、環境で設定されていることを確認してください。

破壊的な操作

次のコマンドは破壊的または取り消し不能です。実行する前に、必ずユーザーに確認してください：

• acli jira workitem delete — 作業項目を完全に削除します
• acli jira project delete — プロジェクトとすべての作業項目を完全に削除します
• acli admin user delete — 管理対象ユーザーアカウントを削除します
• acli admin user deactivate — ユーザーアカウントを無効化します
• acli jira field delete — カスタムフィールドをごみ箱に移動します

次のコマンドは影響が大きいものの、元に戻せます：

• acli jira workitem archive / unarchive
• acli jira project archive / restore
• acli admin user cancel-delete — 保留中の削除を取り消します
• acli jira field cancel-delete — ごみ箱からフィールドを復元します

エージェントの安全ルール：

1. --yes が使用可能な場合でも、ユーザーの明示的な確認なしに破壊的なコマンドを実行しないでください。
2. --jql または --filter で対象を一括指定する場合は、まず同じクエリで検索を実行し、影響を受ける対象をユーザーに提示してください。
3. 破壊的な変更を適用する前に、対象を確認するため、--json 出力を優先してください。
4. ユーザーが無人実行を明示的に要求しない限り、破壊的な一括操作で --yes を併用しないでください。

組織管理者コマンド

acli admin 配下のコマンド（admin user activate、deactivate、delete、cancel-delete を含む）は、Atlassian 組織全体に影響します。影響範囲は組織全体であり、単一のプロジェクトやサイトに限定されません。他の破壊的な操作とは別の段階として扱ってください：

1. **現在のターンで、あらためてユーザーの確認を得てください。**セッションの前のターンで得た承認は、次の管理者コマンドには引き継がれません。ユーザーが直前に類似の管理者コマンドを承認していても、必ず再確認してください。
2. 実行前に、解決された対象を列挙してください。admin user コマンドでは、まず --email、--id、または --from-file の入力を具体的な一覧（件数と各メールアドレス／アカウント ID）に解決し、ユーザーに提示してください。これにより、カンマ区切りリストの入力ミス、ファイル内の古い項目、曖昧な部分一致を検出できます。
3. **admin user delete または admin user deactivate では、--ignore-errors を決して使用しないでください。**一括管理者操作で一部が失敗した場合は、黙って続行せず、停止して調査してください。無効化が中途半端に適用された状態は、完全に停止した状態より監査が困難です。

コマンド構造

acli <command> [<subcommand> ...] {MANDATORY FLAGS} [OPTIONAL FLAGS]

最上位のコマンドグループは4つです：

• acli jira - Jira Cloud の操作（作業項目、プロジェクト、ボード、スプリント、フィルター、ダッシュボード、フィールド）
• acli admin - 組織管理（ユーザー管理、認証）
• acli rovodev - Rovo Dev AI コーディングエージェント（ベータ）
• acli feedback - フィードバック／バグ報告の送信

一般的なパターン

出力形式

ほとんどの一覧表示／検索コマンドは、--json、--csv、およびデフォルトのテーブル出力に対応しています。

一括操作

以下を指定して複数の項目を対象にできます。

• --key "KEY-1,KEY-2,KEY-3" - カンマ区切りのキー
• --jql "project = TEAM AND status = 'To Do'" - JQL クエリ
• --filter 10001 - 保存済みフィルター ID
• --from-file "items.txt" - キー／IDを記載したファイル（カンマ、空白、改行区切り）

一括操作でエラーが発生しても処理を続けるには、--ignore-errors を使用します。 確認プロンプトを省略するには、--yes / -y を使用します（自動化に便利です）。

ページネーション

• --limit N - 返す項目の最大数（デフォルトは状況により30～50）
• --paginate - すべてのページを自動的に取得します（--limit より優先されます）

JSON テンプレート

多くの作成／編集コマンドは、--generate-json でテンプレートを生成し、--from-json で読み込むことができます。

acli jira workitem create --generate-json > template.json
# edit template.json
acli jira workitem create --from-json template.json

クイックリファレンス：よく使う操作

作業項目

# Create
acli jira workitem create --summary "Fix login bug" --project "TEAM" --type "Bug"
acli jira workitem create --summary "New feature" --project "TEAM" --type "Story" --assignee "@me" --label "frontend,p1"

# Search
acli jira workitem search --jql "project = TEAM AND assignee = currentUser()" --json
acli jira workitem search --jql "project = TEAM AND status = 'In Progress'" --fields "key,summary,assignee" --csv

# View
acli jira workitem view KEY-123
acli jira workitem view KEY-123 --json --fields "*all"

# Edit
acli jira workitem edit --key "KEY-123" --summary "Updated title" --assignee "[email protected]"

# Transition
acli jira workitem transition --key "KEY-123" --status "Done"
acli jira workitem transition --jql "project = TEAM AND sprint in openSprints()" --status "In Progress"

# Assign
acli jira workitem assign --key "KEY-123" --assignee "@me"

# Comment
acli jira workitem comment create --key "KEY-123" --body "Work completed"

# Bulk create
acli jira workitem create-bulk --from-csv issues.csv

プロジェクト

acli jira project list --paginate --json
acli jira project view --key "TEAM" --json
acli jira project create --from-project "TEAM" --key "NEW" --name "New Project"

ボードとスプリント

acli jira board search --project "TEAM"
acli jira board list-sprints --id 123 --state active
acli jira sprint list-workitems --sprint 1 --board 6

詳細なコマンドリファレンス

すべてのコマンドのフラグの詳細、パラメーター、使用例については、以下を参照してください。

• Jira 作業項目コマンド（作成、編集、検索、割り当て、ステータス遷移、コメント、複製、リンク、アーカイブ、添付ファイル、ウォッチャー）：references/jira-workitem-commands.md を参照してください
• その他すべてのコマンド（jira project/board/sprint/filter/dashboard/field、admin、rovodev、feedback）：references/other-commands.md を参照してください