---
name: pr
description: Commit all changes via jsc-git:commit, create a target branch named from the highest-priority commit type plus a summarized title, push, then open a Gitea PR with the templated description. Branch priority is revert > fix > feat > perf > refactor > test > docs > style > chore. Use when work is ready for review; not for plain commits.
---

# pr — 建立 Push Request

## 步驟

1. 呼叫 `jsc-git:commit` 將所有檔案變更認可完成。
2. 決定來源分支：遠端存在 `develop` 就用 `develop`，否則用 `main`（再否則用 `master`）。
3. 從遠端來源分支建立目標分支：
   1. 類型取所有 commit 中優先度最高者：`revert > fix > feat > perf > refactor > test > docs > style > chore`。
   2. 標題從所有 commit 的訊息總結出一句。
   3. 分支名**只允許 ASCII**，一律 slug 化：`{類型}/{需求 or 功能}-{標題}`。需求/功能與標題先翻譯成英文短語，再轉小寫、非 `a-z0-9` 字元以連字號取代、連續連字號合併、頭尾連字號移除（例：`feat/order-匯出報表` → `feat/order-export-report`）。不可含空白、括號、冒號與任何非 ASCII 字元。
4. `git push -u origin {目標分支}`。
5. 建立 PR：`jsc-gitea/tools/gitea.sh pr-create {owner}/{repo} {目標分支} {來源分支} "{分支名}" {描述檔}`。
   - 標題 = 分支名。
   - 描述先套用 `templates/pr-description.md` 寫入暫存檔再帶入。
6. **前置 PR 阻擋**：描述中有前置 Push Request 時，執行
   `jsc-gitea/tools/gitea.sh pr-depend {owner}/{repo} {本 PR 編號} {前置 owner}/{repo} {前置 PR 編號}`
   把本 PR 掛上依賴；前置 PR 未關閉前 Gitea 會阻擋合併，避免誤合併。API 不可用時降級：PR 標題加 `WIP:` 前綴（Gitea 原生阻擋合併），前置完成後移除。
7. 回報 PR URL。

## 規則

1. 描述範本各節不可留空：沒有計畫/分析頁就填「無」，沒有前置 PR 就填「無」。
2. 計畫頁與分析頁連結由 `jsc-sdlc` 的 wiki 頁取得；分析頁連結必須導向工作包標題錨點。
3. 描述草擬的細節**必須以 sub agent 執行**。