SuperAPI AI 工具集

boards-sprint-metrics

数据与分析

查看项目

更新于 10-15 21:11

技能介绍

用途:基于 Azure DevOps Analytics(OData)在服务端汇总数据,产出一个团队最近 N 个(默认 6 个)已结束 Sprint 的交付指标,全程只读,不修改任何数据。

主要能力:生成每个 Sprint 的 Velocity(完成工作项的 Story Points/Effort/Size 合计)、Throughput(完成项数)、Carry-over(Sprint 结束当天仍未完成项数)与完成率(Throughput ÷(Throughput+Carry-over)),并统计 Cycle time、Lead time 的平均、中位数与 P85,偏斜时列出最长 3 笔离群项。

必要用法:组织从环境变量 AZURE_DEVOPS_ORG 读取,PAT 以 Basic 验证送出(-u ":$AZURE_DEVOPS_PAT"),或使用 AZURE_DEVOPS_EXT_PAT、Entra ID 令牌;PAT 需 Analytics (Read) 权限,读流程与团队设置另需 Work Items (Read)、Project and Team (Read)。Analytics 基底网址为 https://analytics.dev.azure.com/$AZURE_DEVOPS_ORG/{project}/_odata/v4.0-preview/,用 curl -G 搭配 --data-urlencode 传 OData 参数。项目与团队未提供时先列出让用户选择;估计属性依 processconfiguration 与 teamsettings 决定,查询回 VS403522 时只报 Throughput 并说明原因;已结束 Sprint 用 IsEnded 判断。

适用场景:需要快速查看团队多个 Sprint 的交付趋势、发现 Carry-over 偏高或估计不足等情况时。

限制:只读取,不修改数据;日期为组织时区;完成后再被移到其他 Sprint 的项会归入新 Sprint;需自行处理分页与授权错误;PowerShell 下需用 curl.exe 并注意转义。其他未在资料中说明的事项暂未提供。