关于 boards-backlog-summary
这是一个用于 Azure DevOps 的技能,可按优先级汇总团队需求级待办事项,列出分配给当前用户的活动项及其父项和子项详情。
主要功能
- 01筛选分配给当前用户的活动项
- 02支持 Product Backlog Item 和 Bug 类型
- 03获取父项和子项详情
- 04按优先级升序排列
- 05格式化显示字段与子项
适用场景
- 01按项目和团队查看个人活动待办
- 02检查已分配事项关联的父项和子项
MCP 相关
通过 Azure DevOps MCP Server 工具列出项目与团队,并获取待办列表及工作项详情。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ microsoft/ azure-devops-skills --skill boards-backlog-summary安装后在 Claude Code 中输入/boards-backlog-summary确认已加载。
详细介绍
获取团队待办事项摘要
此技能会检索团队的需求级待办事项,将其筛选为活动且分配给当前用户的事项,补充其父项和子项的工作项详细信息,并按优先级排序后显示。
项目选择
- 如果用户在请求中提供了项目名称(例如“Contoso 项目”),请直接使用该项目,不要调用
core_list_projects。 - 如果未提供项目名称,请向用户询问一次。
- 如果询问一次后仍未提供项目名称,请调用
core_list_projects,返回供用户选择的项目列表。 - 如果未提供或选定项目,请勿继续。
团队选择
- 如果用户提供了团队名称,请直接使用该团队,不要调用
core_list_project_teams。 - 如果未提供团队名称,请向用户询问一次。
- 如果询问一次后仍未提供团队名称,请针对已选项目调用
core_list_project_teams,供用户选择团队。 - 如果未提供或选定团队,请勿继续。
工具
所有与 Azure DevOps 的交互都使用 Azure DevOps MCP Server 工具。
core_list_projects:获取供用户选择的项目列表。core_list_project_teams:获取项目的团队列表。wit_backlog(操作:list_work_items):获取团队在指定待办事项级别上的工作项。wit_work_item(操作:get_batch):按 ID 批量获取工作项详细信息。尽可能少地调用此工具,以获取待办事项及其父项和子项的字段和关系。
步骤
-
按照上述规则确定项目和团队。
-
针对已确定的项目和团队调用
wit_backlog,操作为list_work_items,待办事项级别使用Microsoft.RequirementCategory(需求/产品待办事项级别)。 -
在返回的工作项中,筛选出符合以下所有条件的事项:
System.State=ActiveSystem.AssignedTo与当前用户匹配System.WorkItemType属于以下类型之一:Product Backlog Item、Bug
-
如果没有符合筛选条件的事项,请显示一条消息,说明该团队没有分配给当前用户的活动待办事项,然后停止。
-
对所有筛选出的事项 ID 调用
wit_work_item,操作为get_batch,设置expand=relations,并获取以下字段:System.IdSystem.TitleSystem.StateSystem.AssignedToSystem.WorkItemTypeSystem.ChangedDateSystem.IterationPathMicrosoft.VSTS.Common.PrioritySystem.Parent
-
从每个事项的
relations中收集所有父项 ID(System.LinkTypes.Hierarchy-Reverse)和子项 ID(System.LinkTypes.Hierarchy-Forward)。将这些 ID 合并后调用一次wit_work_item,操作为get_batch(排除已获取的 ID),以获取其System.Id、System.Title和System.State。 -
按照下方显示结果部分的说明显示结果。
显示结果
按 Microsoft.VSTS.Common.Priority 升序对所有事项排序(优先级 1 排在最前)。对每个事项,显示:
{ID} — {Title}
| 字段 | 值 |
|---|---|
| 状态 | {System.State} |
| 优先级 | {Microsoft.VSTS.Common.Priority} |
| 更改日期 | {System.ChangedDate formatted as MM/DD/YYYY} |
| 迭代 | {last segment of System.IterationPath} |
| 工作项类型 | {System.WorkItemType} |
父项:
- 如果存在父项:
{ParentID}{Parent Title} - 如果不存在父项:(无)
子项:
如果存在子项,请以表格形式显示:
| ID | 标题 | 状态 |
|---|---|---|
| {ChildID} | {Child Title} | {Child State} |
如果不存在子项,请显示:(无)
列出所有项后,显示一行摘要:
当前显示分配给你、属于项目 {project name} 中团队 {team name} 的 {N} 个活动待办事项。