taskery

Taskery Full Operator 技能提供了一套結構化的指令集，旨在賦予 AI 程式設計代理管理 Taskery 環境中任務的能力。Taskery 是一個優先考慮本地運行的看板系統，它將基於 Web 的看板與 CLI 和 API 介面進行同步，使其成為開發者使用 AI 代理自動化專案工作流程的理想工具。透過使用此技能，代理程式可以學習如何透過本地終端指令或 RESTful API 端點與 Taskery SQLite 資料庫進行互動，同時遵守防止資料衝突所需的樂觀併發模型。

此技能適用於需要在本地開發環境中運行的 AI 代理，這些代理需要從程式碼生成轉換為專案管理任務，例如建立追蹤票據、在狀態欄中移動任務或標記依賴關係。它涵蓋了任務管理的全生命週期，從最初的建立到最終的刪除，確保代理程式能夠有效地與使用相同看板的人類團隊成員進行協作。

• 全生命週期管理：建立、檢查、更新、移動、審核、完成及刪除任務。

• CLI 精通：深度整合 list、show、create、update 和 move 等指令，並包含狀態、優先級和負責人的篩選器使用方法。

• API 能力：與 REST 端點互動，包括任務管理、系統健康檢查和全域通知設定。

• 樂觀併發控制：透過 expectedVersion 嚴格遵守版本控制要求，防止多個代理或用戶同時更新時出現資料競爭。

• 工作流程自動化：指導代理程式如何使用退出碼（0–4）進行穩健的錯誤處理，並在發生版本衝突時執行自動重試。

• 環境通用性：支援預設本地運行模式及自訂 API 基本 URL 設定，部署靈活。

• 在執行修改操作前，務必先執行 'show <id>' 以獲取當前的任務版本。

• 使用 CLI 的 JSON 輸出格式，以確保在任務解析過程中的機器可讀性。

• 狀態包含 PENDING、STARTED、BLOCKED、REVIEW 和 COMPLETE。

• 優先級從 LOW 到 URGENT，有助於進行有效的積壓任務分類。

• 若遇到 VERSION_CONFLICT（退出碼 4），請僅重試一次。

• 每次寫入操作後，請透過呼叫 list 指令驗證狀態，以確保看板資料的一致性。