SuperAPI AI 工具集

boards-work-item-summary

办公与效率

查看项目

更新于 10-15 21:11

技能介绍

用途:針對單一 Azure DevOps 工作項目 ID 產生摘要,涵蓋欄位、關聯連結、連結的 Pull Request 與留言。工作項目 ID 在整個組織內唯一,不需要先指定專案。

主要能力:一次取回欄位、關聯與連結;從 relations 收集連結的工作項目 ID,以 workitemsbatch 批次(每次最多 200 個 ID)取得標題、狀態、類型等;解析 Pull Request ArtifactLink 並查詢 PR 標題、狀態與網址;取得留言(totalCount、comments[].text,必要時用 continuationToken 續取)。

使用方式:使用者提供 ID(如 115770)就直接使用;未提供時詢問一次,提示後仍無 ID 就回覆需要工作項目 ID 並停止,不呼叫任何 API。連線使用 curl 呼叫 Azure DevOps REST API,每個指令自帶驗證。組織讀取環境變數 AZURE_DEVOPS_ORG,未設定時詢問一次,若給網址則從 https://dev.azure.com/{org} 或 https://{org}.visualstudio.com 取出組織名稱。權杖以 Basic 驗證送出 -u ":$AZURE_DEVOPS_PAT",或改用 AZURE_DEVOPS_EXT_PAT;使用 Microsoft Entra ID 時改為 -H "Authorization: Bearer $AZURE_DEVOPS_TOKEN";皆未設定則請使用者在終端機設定後重試並停止。權杖只從環境變數讀取,不貼進對話、不列印或寫入檔案。PAT 權限需 Work Items (Read),讀 PR 細節另需 Code (Read)。路徑中專案名稱要 URL 編碼(空白寫 %20),查詢字串的 $ 寫成 %24。Windows PowerShell 要用 curl.exe,環境變數寫 $env:AZURE_DEVOPS_PAT,並先把 JSON 主體寫入暫存檔再以 --data-binary "@body.json" 送出。

呈現:主項目欄位含 ID、標題、狀態、指派對象(只顯示 displayName)、類型、建立日期、優先順序、標籤;連結表格每列含可點擊的超連結、連結類型、類型、標題、狀態,依 Parent → Child → Related → 其他排序;有 PR 時另列 PR 表格;以白話摘要描述、系統資訊與重現步驟;說明留言總數並簡述主要議題或決定,無留言時明確說明。

限制:HTTP 401、403、203 或回應為 HTML 登入頁代表權杖無效、過期或權限不足,回報後停止;404 代表組織名稱或 ID 有誤。其他 ArtifactLink(Commit、Build、Release)不列入摘要。權杖缺少 Code (Read) 時仍列出 PR ID,但註明無法取得細節。欄位與留言內容為 HTML,閱讀時需略過標籤。