工作項目摘要

這個 Skill 一律針對一個特定的工作項目 ID。工作項目 ID 在整個組織內唯一，因此不需要先選專案。

• 使用者有提供 ID（例如「115770」或「work item 115770」）就直接使用。
• 沒有提供時，請使用者提供一次。
• 提示後仍沒有 ID，就回覆「需要工作項目 ID」並停止，不呼叫任何 API。

連線與驗證

一律用 curl 直接呼叫 Azure DevOps REST API，每個指令都自帶驗證參數。

• 組織：讀取環境變數 AZURE_DEVOPS_ORG（組織名稱，例如 contoso）。未設定時詢問使用者一次；使用者給的是網址時，從 https://dev.azure.com/{org} 或 https://{org}.visualstudio.com 取出組織名稱。
• 權杖：PAT 以 Basic 驗證送出：-u ":$AZURE_DEVOPS_PAT"；只設定了 AZURE_DEVOPS_EXT_PAT（Azure CLI azure-devops 擴充套件使用的變數）時，改用它。改用 Microsoft Entra ID 權杖時，換成 -H "Authorization: Bearer $AZURE_DEVOPS_TOKEN"。都未設定時，請使用者在自己的終端機設定 AZURE_DEVOPS_PAT 後重試，並停止。權杖只從環境變數讀取：不要請使用者把權杖貼進對話，也不要印出或寫入檔案。
• PAT 權限範圍：Work Items (Read)；要讀取 Pull Request 細節另需 Code (Read)。
• 編碼：路徑中的專案名稱要 URL 編碼（空白寫成 %20）；查詢字串中的 $ 寫成 %24（例如 %24expand），避免被 shell 展開。
• 錯誤：HTTP 401、403、203 或回應是 HTML 登入頁，代表權杖無效、過期或權限不足，回報後停止；HTTP 404 代表組織名稱或 ID 有誤。
• Windows PowerShell：呼叫 curl.exe（而非 curl 別名），環境變數寫成 $env:AZURE_DEVOPS_PAT；PowerShell 不支援 <<'EOF'，先把 JSON 主體寫入暫存檔，再以 --data-binary "@body.json" 送出。