jira-communication

jira-communication 技能為 Atlassian Jira 環境（包含雲端版與伺服器/Data Center 版）提供了強大的 CLI 介面。此技能專為偏好在終端機作業的開發人員與專案經理所設計，透過 uv 管理的專用 Python 指令碼執行各項操作。當 MCP 工具無法使用或需要對 Jira API 進行更精細的控制時，它可作為強大的替代方案。透過針對 Jira 網址與專案工單編號（如 PROJ-123）的自動觸發機制，它能實現無縫且具備情境感知的作業流程，減少手動切換任務的需求。

• 完整支援核心工單管理作業，包含建立、更新、移動、轉換狀態與刪除工單。

• 先進的搜尋能力，利用 Jira 查詢語言 (JQL) 根據狀態、指派對象或自訂標準來篩選工單。

• 整合工時追蹤功能，可直接在 CLI 中新增與查詢工時記錄。

• 全面的敏捷管理工具，用於查詢衝刺 (Sprint) 資料、看板內容與版本發布。

• 附件處理功能，支援與工單關聯之檔案的安全上傳與下載。

• 公用程式功能，可管理工單連結、觀察者、使用者資訊與自訂欄位查詢。

• 情境感知驗證與設定指令碼，確保環境變數與 API 憑證設定正確。

• 此技能依賴 uv 管理相依性並執行指令碼，執行環境需具備 Python 3.10+。

• 驗證支援 JIRA_URL、JIRA_USERNAME 與 API Token，配置檔統一使用 .env.jira 或 profiles.json。

• 執行更新或刪除等破壞性操作時，應搭配 --dry-run 旗標以預覽變更，避免意外操作。

• 輸出格式可使用 --json 進行切換，以便與後續的資料處理工具或腳本進行整合。

• 本工具針對 Jira Wiki 標記語法設計，若涉及複雜格式內容，建議搭配 jira-syntax 技能使用。

• 實作安全性最佳實務，包含附件下載的 SSRF 防護以及透過 --debug 模式進行標準化錯誤報告。