SuperAPI AI 工具集

boards-query

办公与效率

查看项目

更新于 10-15 21:11

技能介绍

用途:通过 Azure DevOps REST API 执行 WIQL 临时查询或已保存查询,并依照查询自身字段呈现结果。此技能只读取;要固定格式的“我的工作”报表改用 boards-my-work,要修改工作项改用 boards-work-item-write。

主要能力:支持临场编写 WIQL(含 @Me、@Today、@CurrentIteration 等宏与 @TeamAreas),列出或按名称、路径、ID 搜索共用查询(Shared Queries)与我的查询(My Queries),并以表格、树状或直接链接形式呈现,同时补齐 ID 对应的字段值。

使用方式:一律用 curl 直接调用 REST API,命令自带验证参数。组织读取环境变量 AZURE_DEVOPS_ORG;PAT 以 Basic 验证发送 -u ":$AZURE_DEVOPS_PAT",若只设置 AZURE_DEVOPS_EXT_PAT 则改用它,Entra ID 令牌用 -H "Authorization: Bearer $AZURE_DEVOPS_TOKEN"。令牌只从环境变量读取,不要粘贴进对话或写入文件。执行前需确定项目(未提供则询问或列出选择),团队仅在用到 @CurrentIteration 且非默认团队时才放进 URL。路径、中文名称与关键字的特殊字符需 URL 编码。

限制:WIQL 结果上限 20,000 笔,超过会静默截断;WIQL 本身上限 32,000 字符。401、403、203 或返回 HTML 登录页表示令牌无效、过期或权限不足;404 表示组织、项目、团队或查询路径有误;400 会指出 WIQL 问题(如字段不存在、团队没有当前 Iteration)。/wiql 只返回 ID,字段值需另外通过 workitemsbatch 批次获取,每次最多 200 个 ID。Windows PowerShell 中需使用 curl.exe,环境变量写作 $env:AZURE_DEVOPS_PAT,且不支持 heredoc,应先把 JSON 主体写入临时文件再以 --data-binary "@body.json" 发送。