pr

<!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28): PR lifecycle orchestration (5-step: CREATE→REVIEW→APPROVE→MERGE→CLEANUP, size gate >400 lines block, CI gate, squash/merge strategy, gh CLI integration) relocated to adoption layer (XSPEC-095, 2026-04-28). This Skill retains: PR description template, merge strategy decision matrix, auto-review trigger rules. For enforced lifecycle execution, use your adoption layer's toolchain. --> # PR Automation Assistant | PR 自動化助手 > ⚠️ **Status: Reference（參考用，非可執行流程）** — PR 生命週期協調（5 步驟 CREATE→REVIEW→APPROVE→MERGE→CLEANUP、>400 行 size gate、CI gate、squash/merge 策略、gh CLI 整合）已於 2026-04-28 移至 **adoption layer（XSPEC-095）**。此處保留 PR 描述模板、合併策略決策矩陣、auto-review 觸發規則供參考。 > Lifecycle orchestration has moved to the adoption layer (XSPEC-095); this document is **reference-only**. For enforced execution, use your adoption layer's toolchain. Streamline the pull request lifecycle from creation to merge. 簡化從建立到合併的 Pull Request 生命週期。 ## PR Creation Checklist | PR 建立檢查清單 | Item | Rule | 規則 | |------|------|------| | Title | `<type>(<scope>): <summary>` under 70 chars | 70 字元內，遵循 conventional commits | | Description | Use structured template below | 使用下方結構化模板 | | Labels | At least one category label | 至少一個分類標籤 | | Reviewers | Assign based on CODEOWNERS or domain | 依 CODEOWNERS 或領域指派 | | Branch | Up to date with base branch | 與基礎分支同步 | ## PR Description Template | PR 描述模板 ```markdown ## Summary | 摘要 <1-3 bullet points describing the change> ## Changes | 變更內容 - Added / Modified / Removed ... ## Test Plan | 測試計畫 - [ ] Unit tests pass - [ ] Manual verification steps ## Screenshots | 截圖 (if UI changes) ``` ## Merge Strategy Decision | 合併策略決策 | Strategy | When to Use | 使用時機 | |----------|-------------|----------| | **Squash merge** | Feature branches with messy commits | 功能分支，提交記錄零散 | | **Merge commit** | Release branches, preserve history | 發布分支，保留完整歷史 | | **Rebase** | Linear history, small changes | 線性歷史，小幅變更 | ## Auto-Review Triggers | 自動審查觸發條件 | Trigger | Threshold | Action | 動作 | |---------|-----------|--------|------| | PR size | > 400 lines changed | Request split | 要求拆分 | | No tests | 0 test files changed | Block merge | 阻止合併 | | CI failure | Any check fails | Block merge | 阻止合併 | | Stale PR | > 7 days no activity | Notify author | 通知作者 | | Draft PR | Marked as draft | Skip reviewers | 跳過審查者指派 | ## Workflow | 工作流程 ``` CREATE ──► REVIEW ──► APPROVE ──► MERGE ──► CLEANUP ``` 1. **Create** — Branch, commit, push, open PR with template 2. **Review** — Automated checks + human review 3. **Approve** — All checks green, required approvals met 4. **Merge** — Apply chosen merge strategy 5. **Cleanup** — Delete source branch, update linked issues ## Usage | 使用方式 ``` /pr - Guide PR creation for current branch | 引導建立當前分支的 PR /pr create - Create PR with template | 使用模板建立 PR /pr --template - Show PR description template | 顯示 PR 描述模板 /pr review 123 - Review specific PR | 審查特定 PR ``` ## Next Steps Guidance | 下一步引導 After `/pr` completes, the AI assistant should suggest: > **PR 操作完成。建議下一步 / PR operation complete. Suggested next steps:** > - 執行 `/code-review` 進行詳細程式碼審查 ⭐ **Recommended / 推薦** — Run detailed code review > - 執行 `/commit` 修正審查發現的問題 — Fix issues found in review > - 執行 `/changelog` 更新變更日誌 — Update changelog > - 檢查 CI 狀態 → `gh pr checks` — Check CI status ## Reference | 參考 - Core standard: [code-review-checklist.md](../../core/code-review-checklist.md) - Core standard: [git-workflow.md](../../core/git-workflow.md) ## Version History | 版本歷史 | Version | Date | Changes | 變更說明 | |---------|------|---------|----------| | 1.0.0 | 2026-03-23 | Initial release | 初始版本 | ## AI Agent Behavior | AI 代理行為 > 完整的 AI 行為定義請參閱對應的命令文件：[`/pr`](../commands/pr.md#ai-agent-behavior--ai-代理行為) > > For complete AI agent behavior definition, see the corresponding command file: [`/pr`](../commands/pr.md#ai-agent-behavior--ai-代理行為) ## License | 授權 CC BY 4.0 — Documentation content