pipelines-build-summary

パイプラインのビルド概要

このスキルはプロジェクトのコンテキストで動作します。パイプライン定義またはビルド IDは任意で、ユーザーの依頼内容によって必要かどうかが異なります。

プロジェクトの選択

• ユーザーがリクエストでプロジェクト名を指定した場合（例：「Contoso で」）、そのプロジェクトを直接使用し、core_list_projects は呼び出さないでください。
• ユーザーがプロジェクト名を指定していない場合は、まず一度だけプロジェクト名を尋ねてください。
• 一度尋ねてもプロジェクト名が指定されない場合は、core_list_projects を呼び出し、ユーザーが選択できるプロジェクトの一覧を返してください。

パイプライン定義の選択

• ユーザーがパイプライン名または定義名を指定した場合は、pipelines_definition を list アクションと name フィルターで使用して、その定義を検索してください。
• ユーザーがパイプラインを指定しておらず、リクエストでパイプラインが必要な場合（例：「最近のビルドを表示」）は、まず一度だけパイプライン名を尋ねてください。
• 一度尋ねてもパイプライン名が指定されない場合は、pipelines_definition を list アクションで呼び出し、ユーザーが選択できる定義の一覧を表示してください。

ツール

Azure DevOps とのすべてのやり取りには、Azure DevOps MCP Server ツールを使用してください。

• core_list_projects：組織内のプロジェクト一覧を取得します。
• pipelines_definition（list アクション）：プロジェクトのビルド／パイプライン定義一覧を取得します。
• pipelines_build（list アクション）：定義、ブランチ、またはステータスで絞り込んだビルド一覧を取得します。
• pipelines_build（get_status アクション）：ID を指定して、特定のビルドのステータスと結果を取得します。
• pipelines_build_log（list アクション）：特定のビルドのログ一覧を取得します。
• pipelines_build_log（get_content アクション）：ビルドのログ ID を指定して特定のログを取得します（失敗したステップのログの取得に使用します）。
• pipelines_build（get_changes アクション）：特定のビルドに関連するコミット／変更を取得します。

ルール

1. パイプラインの最近のビルドを一覧表示する

• ユーザーがパイプラインのビルド一覧表示または最近のビルドの表示を依頼した場合は、定義 ID で絞り込んで pipelines_build を list アクションで呼び出してください。
• ユーザーが指定した場合は、branchName、statusFilter、または resultFilter で絞り込むこともできます（例：「main の失敗したビルド」）。
• ユーザーが依頼しない限り、ログや変更を取得しないでください。
• 結果は表で表示してください。
• ビルドがない場合は、このパイプラインにビルドがないことを明示してください。

例

• "プロジェクト Contoso のパイプライン 'CI-Main' の最近のビルドを表示"

2. ID でビルドのステータスを取得する

• ユーザーが特定のビルドについて尋ねた場合（例：「ビルド 12345」）、そのビルド ID を指定して pipelines_build を get_status アクションで呼び出してください。
• ビルド番号、ステータス、結果、ソースブランチ、開始／終了時刻、要求者、定義名を表示してください。
• ビルドが失敗した場合は、ログの表示を提案してください。

例

• "プロジェクト Contoso のビルド 12345 のステータスは？"

3. 失敗したビルドのログを表示する

• ユーザーがログの表示またはビルドの失敗理由を尋ねた場合は、まず pipelines_build_log を list アクションで呼び出し、そのビルドのすべてのログエントリの一覧を取得してください。
• ログ一覧から失敗したステップを特定してください（エラーや失敗を示すステップを探します）。
• 関連する失敗ログエントリを指定して pipelines_build_log を get_content アクションで呼び出し、実際のログ内容を取得してください。
• ログの出力は読みやすいようにコードブロックで表示してください。
• すべてのログを出力しないでください。失敗したステップと、関連する各ログの末尾部分に絞ってください。

例

• "プロジェクト Contoso のビルド 12345 のログを表示してください"
• "ビルド 12345 が失敗した理由を教えてください"

4. ビルドの変更を一覧表示する

• ユーザーがビルドの変更内容の確認またはコミットの一覧表示を依頼した場合は、ビルド ID を指定して pipelines_build を get_changes アクションで呼び出してください。
• コミット ID、作成者、メッセージを含む表で結果を表示してください。
• 変更がない場合は、このビルドに関連する変更がないことを明示してください。

例

• 「ビルド 12345 の変更内容は何ですか？」
• 「プロジェクト Contoso のビルド 12345 のコミット一覧を表示してください」

結果の表示

ビルド一覧を表示するときは、次の項目を表に表示します。

• ビルド ID：次の形式のクリック可能なハイパーリンク：[{buildId}](https://dev.azure.com/{organization}/{project}/_build/results?buildId={buildId})
• 定義名
• ステータス（例：completed、inProgress、cancelling、notStarted）
• 結果（例：succeeded、failed、canceled、partiallySucceeded） — 絵文字を使用します：✅ succeeded、❌ failed、⚠️ partiallySucceeded、🚫 canceled
• ソースブランチ
• 開始時刻：MM/DD/YYYY HH:MM 形式
• 要求者（表示名のみ）

単一のビルドのステータスを表示するときは、上記のすべての項目に加えて、次の項目も表示します。

• 終了時刻：MM/DD/YYYY HH:MM 形式
• ビルド番号
• 所要時間（開始時刻と終了時刻から算出）

変更内容を表示するときは、次の項目を表に表示します。

• コミット ID（短縮ハッシュ、先頭 8 文字）
• 作成者
• メッセージ（1 行目のみ）
• タイムスタンプ