关于 boards-work-item-summary
用于按 ID 获取并总结单个 Azure DevOps 工作项的技能,涵盖关联项和评论。它规定了信息收集步骤,并以结构化表格呈现结果。
主要功能
- 01按 ID 获取工作项
- 02检索关联工作项详情
- 03列出评论
- 04单独展示拉取请求
- 05总结描述与复现步骤
适用场景
- 01查看工作项及其关联项
- 02检查问题评论与决策
- 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)返回的链接。
步骤
-
针对请求的 ID,调用
wit_work_item,设置 action 为get、expand=all,以便在一次调用中获取字段、关系和链接。 -
如果工作项有父项(例如
System.Parent或System.LinkTypes.Hierarchy-Reverse关系),将父项 ID 加入需要汇总的关联 ID 集合。无需单独调用;在下一步使用wit_work_item(action:get_batch)即可。 -
从工作项的
relations数组中收集所有关联的工作项 ID(父项、子项、相关项及其他项)。使用这些 ID 调用一次wit_work_item(action:get_batch),获取所有关联工作项的详情。 -
调用一次
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,最后是其他链接类型。
- Id,并使用以下精确格式创建可点击的超链接:
-
如果工作项关联了拉取请求(例如通过构件链接或特定的 PR 关系),请在单独的 Pull Requests 表格中列出,至少包含 PR ID、标题、状态和可点击的 PR 链接。
-
使用通俗易懂的语言简要概述工作项的描述、系统信息和重现步骤(如果有这些字段)。重点说明主要意图、范围,以及关键技术细节或重现细节。
-
对于评论:
- 如果存在一个或多个评论,说明评论总数,并简要概述其中提到的主要主题或决定。
- 如果没有评论,明确说明该工作项没有评论。