gh-ticket

此技能作為 GitHub Issue 生命週期的技術文件助手。它專為工程師、團隊負責人與專案經理設計，旨在透過強制記錄系統狀態、技術證據與具體需求，解決「模糊工單」的問題。在想法或錯誤被識別的當下，即時捕獲新鮮的上下文，確保開發週期中不會遺失技術細節。

• 自動上下文提取：引導使用者記錄觸發來源、相關檔案路徑、錯誤訊息以及當前與期望狀態。

• 技術證據收集：包含用於執行 git log 指令、透過 grep 搜尋檔案，以及使用 GitHub CLI (gh) 交叉比對現有 issue 或 PR 的預設流程。

• 結構化需求建模：強制使用包含功能需求、邊緣案例與可驗證驗收標準的標準化模板，確保符合「完成定義」。

• 實作指引：為開發者架構筆記，包括受影響檔案列表（修改/建立/刪除）、關鍵程式碼位置與相依性追蹤。

• 標準化文件：透過對每個建立的工單使用強制性模板結構，提升專案間的工單追蹤一致性。

• 適用場景：捕獲複雜錯誤、規劃新功能或記錄需要採取行動的調查發現。

• 工作流程：遵循四個階段：上下文捕獲、需求提取、實作指引與標準工單結構生成。

• 輸入/輸出：接收開發者的調查筆記與技術上下文；產出格式完整、具備高度上下文的 GitHub Issue，供團隊使用。

• 限制：需要存取 GitHub CLI (gh) 以獲得最佳的交叉比對效果，並適用於將工單視為開發任務主要真理來源的協作環境。