ado

アクティベーション契約

タスクが Azure DevOps に関係する場合に読み込みます。対象には、プルリクエスト（レビュー、投票、コメント、差分、作成、チェーン）、作業項目（一覧表示、取得、更新、作成）、プロフィールが含まれます。すべての操作で ado CLI を使用してください。

厳守事項

• すべての操作は ado CLI（ado <group> <sub>）を通じて実行してください。1 つのアクションにつきコマンドは 1 つです。
• 変更を加える前に確認してください。vote、comment、update、create、chain の前に、PR/WI の状態を読み取ってください。
• ID、リポジトリ、ブランチ名を決して推測しないでください。先に読み取りコマンドで確認してください。
• [repo] は省略可能です。省略すると、ID で PR が自動検出されます。指定したリポジトリを一覧表示するプロフィールが選択されます。--profile <name> で上書きできます。
• コマンドで一覧に記載されているフラグのみを渡してください。不明なフラグはエラーになります（「もしかして」の候補が表示されます）。ado <group> <cmd> --help で確認してください。
• 長文または複数行の本文はファイルに書き込み、--comment-file <path> を渡してください（pr comment、pr reply、wi comment、wi update）。

判断ゲート

必要なこと	コマンドグループ
構成する／未設定／「プロファイルなし」または認証エラー	ado init、ado config、ado show → references/setup.md を参照
作業項目の作成を有効化／無効化、または制限する	.adoconfig.toml の [work_item.create] を編集 → references/setup.md を参照
使用するプロフィール／切り替え	ado profile · ado profile use <name>
PR を確認する	ado pr get/context/threads/diff/file
PR に対して操作する	ado pr vote/comment/reply/create/chain
作業項目を確認する	ado wi get/list/related/types
作業項目に対して操作する	ado wi update/comment/create/create-child

実行手順

1. コンテキストを確認します。ado profile を実行し、アクティブなプロフィールが間違っている場合は ado profile use を実行します。
2. 対象を読み取ります。例：ado pr context <prId> または ado wi get <id>。
3. 変更操作は 1 つのコマンドで実行します。--comment/--state などをフラグとして渡します。
4. CLI の出力をそのまま報告し、エラー行があればユーザーに提示します。

参考資料

• references/commands.md — コマンド一覧、フラグ、例、エラー処理。
• references/workflows.md — タスク別の手順：PR のコードレビュー、作業項目の作成／更新、PR またはチェーンの作成、保留中の作業の検索。
• references/setup.md — インストール、ado init、プロフィール／PAT、.adoconfig.toml のルール（ado wi create が有効かどうか、許可されるタイプ、必須フィールドを含む）。

セットアップ関連の依頼（「ado を構成する」、「CLI をセットアップする」、「プロファイルなし／認証に失敗する」、「作業項目の作成を許可／禁止する」）では、最初に references/setup.md を読んでください。