用途:读取 Azure DevOps 中团队需求层级(Product Backlog Item、User Story、Requirement、Issue 等)的待办清单,逐项对照 Microsoft Learn 建议,列出问题与修正方式。只读取、不修改;修正字段需改用 boards-work-item-write(每笔需使用者确认),补 Sprint 用 work-iterations。
主要能力:检查缺少估计(依流程配置的 typeFields.Effort.referenceName 判断估计字段)、缺少验收条件(AcceptanceCriteria 去 HTML 标签后为空)、没有父项目、进行中但未指派、进行中但没有 Git/GitHub 的 commit、branch、PR 开发链接、待办清单超过 999 项、未来 Iteration 少于 6 个或当前 Iteration 已过期。依据文档包括 Agile 产品管理最佳实践、产品待办清单管理与 Git 开发链接。
使用方式:以 curl 直接调用 Azure DevOps REST API。组织读环境变量 AZURE_DEVOPS_ORG,PAT 以 Basic 验证发送 -u ":$AZURE_DEVOPS_PAT"(或用 AZURE_DEVOPS_EXT_PAT;Entra ID 用 Bearer 令牌)。令牌只从环境变量读取,不要求贴进对话、不打印或写入文件。PAT 权限需 Work Items (Read) 与 Project and Team (Read)。项目、团队与工作项类型名称需 URL 编码,查询字符串 $ 写成 %24。先取流程配置、待办清单 ID、批次取字段与关联、状态与字段定义,再逐项检查并取团队 Iteration。
输出:标题含项目、团队、项目数、估计字段参考名称与检查时间;摘要表标注各检查问题数;明细列出 ID、类型、标题、状态、指派给,超过 20 笔只列前 20 并询问是否列出其余;Iteration 列出当前与未来名称及起讫日期。
限制与注意:HTTP 401、403、203 或返回 HTML 登录页表示令牌无效、过期或权限不足,需停止并回报;404 表示组织、项目或团队名称有误。字段为空的不会出现在 fields 中。Windows PowerShell 需用 curl.exe,环境变量写 $env:AZURE_DEVOPS_PAT,并以暂存文件配合 --data-binary "@body.json" 发送。Iteration 日期可能为 null,需注明未设定日期。未提供项目或团队时须先请用户选择,未确定前不继续。官方未提供收费或价格信息。