0xKoios/技能

Azure DevOps 看板：我的卡片

協助一個人透過 MCP 或 az 管理他們在 Azure Boards 上的卡片。團隊慣例存在設定中；同一套技能適用於不同團隊。

1. 開始前

1. 讀取設定 — ~/.config/ado-boards/config.md（Windows：%USERPROFILE%\.config\ado-boards\config.md）。如果缺少 → 先執行核心設定（workflows/setup.md）；猜測組織/專案會寫到錯誤的地方。標記為 not set yet 的值會在第一次需要時由工作流程收集。
2. 選擇本次使用的後端：
   • MCP：當 Azure DevOps MCP 工具可用時（例如 wit_work_item）：載入 mcp-tools.md（加上一個 az/ 的缺口檔案，僅在該對應文件中記錄了 MCP 缺口時才載入）。
   • az：否則載入 az/README.md 以及此工作流程的單一區段檔案。當 HTML 描述/AC 寫入後出現亂碼，或 PowerShell 引用失敗時，也載入 az/windows.md。確認登入（az account show 或 AZURE_DEVOPS_EXT_PAT）；如果都沒有，使用者自行執行 az login。
   • 兩者都無 → 指向設定。
3. 開啟對應的工作流程（下表）並遵循它。工作流程說明要做什麼；後端檔案說明如何做。§2 中的規則約束兩個後端。

當設定已獲取、一個後端已選定，且工作流程檔案已開啟時，即完成。

使用者自行登入（Entra / az login）。Credentials 不留在聊天中。

2. 規則

讀取不需要權限。每次寫入都需要預覽和明確同意 — 即使工具本身不要求。看板是共享的；MCP 寫入通常跳過提示，因此預覽是關卡。

規則	條件
預覽大小	對使用者自己的卡片進行一次變更 → 一行 (#512: 狀態 作用中 -> 已關閉。確定嗎？)。多次變更，或他人的卡片 → 表格（ID、欄位、舊值、新值）。超過 10 項 → 說明數量並再次確認。
回讀	每次寫入後：報告 ID、變更內容、URL https://dev.azure.com/<org>/<project>/_workitems/edit/<id>。
上層項目	當設定說「上層項目必填：是」，僅在附帶上層項目時建立（孤立項目會從待辦事項檢視中消失）。
錯誤	當設定說錯誤存在其他地方：在現有錯誤下提供一個任務（第二個錯誤會分割歷程）。
外部卡片	設定中的標題前置詞（例如 EXT）：警告評論可能在評論或欄位變更前同步給報表者；關閉時跳過影響。
單位	時間欄位為純數字；單位在設定中。當使用者說出另一種單位時進行轉換，顯示兩者，並始終說明單位名稱（Boards 介面一律顯示 "h"）。
卡片保留	關閉或移動；將卡片留在看板上。僅在全數顯示並獲得同意後才移除評論 — 這兩者都無法復原。
自己的評論	僅編輯或移除使用者自己的評論（ADO 會拒絕其餘部分）。
真實值	要求提供估計值、指派對象、日期、影響 — 或留空。虛構的數字會在看板上看起來很真實。
安全引用	安全地引用值；標題可能包含引號。
寫入結尾	寫入後：你做了什麼、你跳過了什麼、一個下一步動作。僅讀取：只回答問題。

3. 工作流程

何時使用	開啟
設定 ado 技能；設定遺失；某些東西變更了	workflows/setup.md
我負責什麼；顯示我的卡片；移動；記錄工時；關閉	workflows/my-cards.md
建立卡片；將故事拆分為任務	workflows/create-card.md
新增、列出、編輯或移除評論	workflows/comments.md
描述或驗收條件	workflows/write-description.md
規劃我的衝刺；我應該優先做什麼	workflows/plan-my-sprint.md

4. Agile 參考（對照設定驗證）

階層：Epic > Feature > User Story > Task。錯誤可依團隊設定位於故事旁或之下。

類型	狀態
Feature / User Story	New, Active, Resolved, Closed, Removed
Bug	New, Active, Resolved, Closed
Task	New, Active, Closed, Removed

上層項目：Task 在 User Story（或 Bug）之下，User Story 在 Feature 之下。自訂狀態和必填欄位會在收集後存在設定中。