github-pr-creation

github-pr-creation 技能專為專業軟體工程師設計，旨在簡化開啟 Pull Request 的流程。它直接與本地 git 環境及 GitHub CLI (gh) 整合，確保 PR 的高品質、文件完備性及符合專案規範。與一般的 AI 代理行為不同，此技能在提交前強制執行嚴格的驗證層，減少程式碼審查中的雜訊，並防止諸如推送到錯誤目標分支或跳過關鍵測試套件等常見錯誤。

• 根據命名慣例自動識別正確的基礎分支（例如：feature/* 到 develop，hotfix/* 到 main）。

• 搜尋並驗證來自 .s2s/plans、.kiro/specs、.cursorrules、GitHub Issues 及通用任務檔案的任務文件。

• 透過對比提交歷史記錄與子任務來確保任務完成度，並在建立前提供待處理工作的總結報告。

• 強制執行 Conventional Commits 標準來產生標題與描述，自動從本地提交中提取範圍 (scope) 與類型 (type)。

• 在 PR 建立前執行預驗證，包括執行本地測試套件以確保建置完整性。

• 動態查詢可用的 GitHub 標籤與里程碑，確保 PR 根據專案配置進行正確分類與追蹤。

• 當您準備好提交分支以進行同儕審查、發布或熱修復時，請使用此技能。

• 在最終提交之前，請務必確認目標分支並檢閱生成的 PR 內容，包括自動產生的主體內容。

• 此技能對您的本地檔案進行唯讀分析，確保在為 GitHub API 產生元數據時的安全性。

• 需要經過驗證的 gh CLI 工作階段才能執行儲存庫操作並獲取里程碑或標籤等元數據。

• 採用 HEREDOC 模式進行 PR 主體產生，以維持嚴格的格式與 Markdown 完整性，確保與團隊的 Pull Request 模板（例如：功能、錯誤修復、版本發布或重構模板）相容。