用途:以 Azure DevOps REST API 取得团队需求层级(Requirements)的待办清单,筛选出进行中且指派给目前使用者的项目(Product Backlog Item、User Story、Requirement、Issue、Bug),补齐父项目与子项目信息,再依优先级呈现。需要了解自己在团队看板上的待办、负责工作或相关 Sprint 项目时适用。
主要能力:先决定项目与团队(使用者未提供时列出清单让其选择);取得团队需求层级待办的工作项 ID(workItems[].target.id);用 WIQL 在服务器端筛选进行中、指派给 @Me、类型为需求或 Bug 的项目;以 workitemsbatch 批次取得字段与关联,收集父项(Hierarchy-Reverse)与子项(Hierarchy-Forward)ID;最后按 Microsoft.VSTS.Common.Priority 从小到大排序呈现,并显示状态、变更日期、Iteration、工作项类型、父项目与子项目表格,附一行摘要。
使用方式与必要限制:一律用 curl 直接呼叫 REST API,每个指令自带验证参数。组织从环境变量 AZURE_DEVOPS_ORG 读取,未设置时询问一次,若给的是网址则从中取出组织名。令牌以 Basic 验证送出:-u ":$AZURE_DEVOPS_PAT";仅设置 AZURE_DEVOPS_EXT_PAT 时改用它;改用 Microsoft Entra ID 令牌时换成 -H "Authorization: Bearer $AZURE_DEVOPS_TOKEN"。都未设置时请使用者自行在终端设置后重试并停止。令牌只从环境变量读取,不要请使用者贴进对话,也不要印出或写入文件。PAT 权限范围:Work Items (Read)、Project and Team (Read)。路径中项目与团队名称需 URL 编码(空白写 %20),查询字串中 $ 写 %24(如 %24top)。ID 超过 1,000 个时分批查询;workitemsbatch 每次最多 200 个 ID。$expand 不能与 fields 同时指定。项目清单有 x-ms-continuationtoken 时加 &continuationToken={token} 取下一页,团队清单以 %24skip 分页。Windows PowerShell 需用 curl.exe,环境变量写成 $env:AZURE_DEVOPS_PAT,且不支持 <<'EOF',需先把 JSON 主体写入暂存文件再以 --data-binary "@body.json" 送出。HTTP 401、403、203 或响应为 HTML 登录页代表令牌无效、过期或权限不足,回报后停止;HTTP 404 代表组织、项目或团队名称有误。
适用场景:查看个人在团队看板上的进行中待办、优先顺序及父子层级关系。自定义流程的进行中状态名称需按该流程调整;未提供项目或团队时需先交互选取。