pr-template

pr-template 技能是一款專為自動化產生高品質、標準化合併請求 (PR) 描述而設計的工具。它專為重視程式碼文件化、審核效率與專案可追溯性的開發團隊所打造。透過強制執行一致的結構，此技能確保審核者能獲得評估變更所需的所有背景資訊，包括商業影響、技術實作選擇以及完整的驗證步驟。對於使用現代網頁技術堆疊（如 TanStack Start、FastAPI、Drizzle 與 SQLModel）的團隊而言，此技能特別有效，因為它鼓勵將技術變更與 Linear 中的特定問題連結，並記錄多租戶隔離或 RLS 政策的更新。

• 自動產生包含摘要、動機、實作細節、測試與檢查清單的結構化 Markdown 模板。

• 強制執行嚴格的品質標準，包括引用 Linear 問題編號（例如 GREY-123）、技術取捨以及明確的測試策略（單元測試、整合測試、E2E、效能基準測試）。

• 提供提交前的檢查清單，以驗證是否符合風格規範（TypeScript 90 字元、Python 130 字元）、型別提示維護以及遷移測試。

• 無縫整合至開發生命週期中，支援開發者在功能開發、錯誤修復或複雜重構之間進行快速的上下文切換。

• 請在功能實作或錯誤修復的最終階段、發起合併請求之前使用此技能。

• 預期輸入包括您最近的提交紀錄以及正在處理的特定 Linear 問題 ID。

• 產出的結果是一個可直接複製的 Markdown 區塊，能確保整個工程團隊維持專業的溝通標準。

• 請確保在模板內記錄所有手動測試步驟，以縮短審核週期並加速合併流程。

• 此技能經配置以支援 Grey Haven 的特定模式（例如儲存庫模式與資料庫架構變更），確保所有架構決策都能透明地傳達給團隊成員。