jira-cli

Jira CLI 是一款強大的互動式命令列公用程式，旨在為開發人員、專案經理與技術團隊成員取代操作繁瑣的 Jira 網頁介面。透過終端使用者介面 (TUI)，使用者無需離開開發環境即可執行日常的 Jira 任務，例如檢視議題、建立工單、狀態轉移及衝刺管理。此工具能顯著減少切換上下文的需求，並透過讓專案管理流程保留在終端機操作中，大幅提升工作效率。

本技能支援 Jira Cloud 與 Jira Server (地端版) 環境，且僅需最低限度的設定即可開始使用。它直接作為 Jira API 的介面，透過直觀的命令處理身分驗證、專案過濾與工單操作。對於需要在儲存庫或終端工作階段中快速檢視待辦議題、紀錄更新或推動工單工作流的開發者而言，這是極具價值的工具。

• 執行全面的議題管理，包括列表、過濾與詳細檢視 Jira 工單。

• 使用命令列參數或互動式提示，進行快速的工單建立、複製與編輯。

• 直接在終端機管理敏捷專案，包含衝刺 (Sprint) 導覽與史詩 (Epic) 關聯設定。

• 執行議題狀態轉移 (例如：進行中、已完成)，並支援新增留言與解析說明。

• 利用 JQL、狀態、優先級、報告者與負責人等參數進行高效過濾。

• 支援以純文字、JSON 原始格式與 CSV 等多種格式輸出資料，方便與外部 Shell 指令碼整合。

• 支援透過 API Token、PAT 或 mTLS 進行安全身分驗證，適用於雲端與企業地端環境。

• 在使用 jira init 初始化工具前，請確保 JIRA_API_TOKEN 環境變數已正確設定。

• 極度適合在 IDE、終端工作階段以及自動化 CI/CD 管線驗證指令碼中使用。

• 不建議用於大量資料遷移或 Jira 管理任務 (如使用者權限管理、架構設定)，這些操作仍需使用正式的 Jira 管理員 UI。

• 設定檔存於 .config.yml，方便在不同目錄中管理多個不同的 Jira 專案。

• 建議啟用 Shell 自動補全 (Bash/Zsh)，以加快對複雜指令與工單 ID 的操作速度。