pipelines-build-summary

Pipeline 构建摘要

此技能适用于项目的上下文。Pipeline 定义或构建 ID为可选项，具体取决于用户的请求。

项目选择

• 如果用户在请求中提供了项目名称（例如“针对 Contoso”），请直接使用该项目，不要调用 core_list_projects。
• 如果用户未提供项目名称，请先询问用户一次，要求其提供项目名称。
• 如果询问一次后用户仍未提供项目名称，请调用 core_list_projects，返回项目列表供用户选择。

Pipeline 定义选择

• 如果用户提供了 Pipeline 或定义名称，请使用 pipelines_definition，并将操作设为 list，通过 name 筛选来查找。
• 如果用户未指定 Pipeline，且请求需要指定 Pipeline（例如“显示最近的构建”），请先询问用户一次，要求其提供 Pipeline 名称。
• 如果询问一次后用户仍未提供 Pipeline 名称，请使用 pipelines_definition，并将操作设为 list，列出可供用户选择的定义。

工具

所有 Azure DevOps 交互都使用 Azure DevOps MCP Server 工具。

• core_list_projects：获取组织中的项目列表。
• pipelines_definition（操作：list）：获取项目的构建／Pipeline 定义列表。
• pipelines_build（操作：list）：获取构建列表，可按定义、分支或状态筛选。
• pipelines_build（操作：get_status）：按 ID 获取特定构建的状态和结果。
• pipelines_build_log（操作：list）：获取特定构建的日志列表。
• pipelines_build_log（操作：get_content）：按日志 ID 获取构建的特定日志（用于检索失败步骤的日志）。
• pipelines_build（操作：get_changes）：获取与特定构建相关的提交／更改。

规则

1. 列出 Pipeline 的最近构建

• 当用户要求列出构建或显示 Pipeline 的最近构建时，调用 pipelines_build，将操作设为 list，并按定义 ID 筛选。
• 如果用户指定了 branchName、statusFilter 或 resultFilter（例如“main 上失败的构建”），可按需添加筛选条件。
• 除非用户提出要求，否则不要获取日志或更改。
• 以表格形式显示结果。
• 如果没有构建，请明确说明此 Pipeline 没有构建。

示例

• “显示项目 Contoso 中 Pipeline 'CI-Main' 的最近构建”

2. 按 ID 获取构建状态

• 当用户询问特定构建（例如“构建 12345”）时，调用 pipelines_build，将操作设为 get_status，并提供该构建 ID。
• 显示构建编号、状态、结果、源分支、开始／完成时间、请求者和定义名称。
• 如果构建失败，建议查看日志。

示例

• “项目 Contoso 中构建 12345 的状态是什么？”

3. 查看失败构建的日志

• 当用户要求查看日志或询问构建失败的原因时，先调用 pipelines_build_log，将操作设为 list，获取构建的所有日志条目列表。
• 从日志列表中找出失败的步骤（查找指示错误或失败的步骤）。
• 对相关失败日志条目调用 pipelines_build_log，将操作设为 get_content，以获取实际日志内容。
• 将日志输出放在代码块中，方便阅读。
• 不要输出所有日志。重点展示失败步骤以及每个相关日志的末尾部分。

示例

• “显示项目 Contoso 中构建 12345 的日志”
• “构建 12345 为什么失败？”

4. 列出构建的更改

• 当用户要求查看更改内容或列出构建的提交时，调用 pipelines_build，将操作设为 get_changes，并提供构建 ID。
• 以表格形式显示结果，包含提交 ID、作者和消息。
• 如果没有更改，请明确说明此构建没有关联的更改。

示例

• "what changes were in build 12345?"
• "list commits for build 12345 in project Contoso"

显示结果

显示构建列表时，请在表格中展示以下信息：

• Build 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
• 构建编号
• 持续时间（根据开始和结束时间计算）

显示更改时，请在表格中展示以下信息：

• Commit ID（短哈希，前 8 个字符）
• 作者
• 消息（仅显示第一行）
• 时间戳