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