mcpField
B
boards-work-item-summary

boards-work-item-summary

github.com/microsoft生产力54116 次安装15 周前更新
代码仓库

关于 boards-work-item-summary

用于按 ID 获取并总结单个 Azure DevOps 工作项的技能,涵盖关联项和评论。它规定了信息收集步骤,并以结构化表格呈现结果。

主要功能

  1. 01按 ID 获取工作项
  2. 02检索关联工作项详情
  3. 03列出评论
  4. 04单独展示拉取请求
  5. 05总结描述与复现步骤

适用场景

  1. 01查看工作项及其关联项
  2. 02检查问题评论与决策
  3. 03汇总关联的拉取请求

MCP 相关

使用 Azure DevOps MCP Server 工具获取工作项详情、关联项和评论。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/microsoft/azure-devops-skills --skill boards-work-item-summary

安装后在 Claude Code 中输入/boards-work-item-summary确认已加载。

详细介绍

获取工作项

此技能始终针对一个特定的工作项 ID。

  • 如果用户提供了 ID(例如:“针对 115770”或“工作项 115770”),直接使用该 ID。
  • 如果用户未提供 ID,则提示用户提供工作项 ID 一次。
  • 如果提示后仍未提供 ID,则停止并明确说明需要工作项 ID,且不要调用任何工具。

工具

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

  • wit_work_item(action: get):根据 ID 从 Azure DevOps 获取工作项。
  • wit_work_item(action: list_comments):根据工作项 ID 获取评论列表。
  • wit_work_item(action: get_batch):根据 ID 批量获取工作项详情。使用此工具获取关联工作项的详情,ID 来自 wit_work_item(action: get)返回的链接。

步骤

  1. 针对请求的 ID,调用 wit_work_item,设置 action 为 get、expand=all,以便在一次调用中获取字段、关系和链接。

  2. 如果工作项有父项(例如 System.Parent 或 System.LinkTypes.Hierarchy-Reverse 关系),将父项 ID 加入需要汇总的关联 ID 集合。无需单独调用;在下一步使用 wit_work_item(action: get_batch)即可。

  3. 从工作项的 relations 数组中收集所有关联的工作项 ID(父项、子项、相关项及其他项)。使用这些 ID 调用一次 wit_work_item(action: get_batch),获取所有关联工作项的详情。

  4. 调用一次 wit_work_item(action: list_comments),获取原始工作项的评论。

显示结果

显示结果时:

  • 为主要工作项显示以下字段:Id、Title、State、Assigned To(仅显示名称,不显示电子邮件)、Work Item Type、格式为 MM/DD/YYYY 的 Created Date、Priority 和 Tags。

  • 提供一个 Links 表格。对于每个关联工作项,显示:

    • Id,并使用以下精确格式创建可点击的超链接:[{ID}](https://dev.azure.com/{organization}/{project}/_workitems/edit/{ID})
    • Link type(例如:Parent、Child、Related,或底层关系名称)
    • Work item type
    • Title
    • State

    按以下顺序分组并排列各行:Parent links 优先,然后是 Child links、Related links,最后是其他链接类型。

  • 如果工作项关联了拉取请求(例如通过构件链接或特定的 PR 关系),请在单独的 Pull Requests 表格中列出,至少包含 PR ID、标题、状态和可点击的 PR 链接。

  • 使用通俗易懂的语言简要概述工作项的描述、系统信息和重现步骤(如果有这些字段)。重点说明主要意图、范围,以及关键技术细节或重现细节。

  • 对于评论:

    • 如果存在一个或多个评论,说明评论总数,并简要概述其中提到的主要主题或决定。
    • 如果没有评论,明确说明该工作项没有评论。

评论

支持 Markdown