 admin
|
8e42050718
|
Merge pull request 'feat(git): PR 分支階梯推導與既有 PR 校準' (#11) from feat/sdlc-flow-rules/pr-ladder-and-sync into feat/sdlc-flow-rules/main
Reviewed-on: #11
|
2026-08-27 03:26:23 +00:00 |
|
 jiantw83
|
f62428a4ac
|
chore(manifest): 三份 manifest 版本升到 0.0.8
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.0.7 改為 0.0.8。
Why：本次改了 `base-branch.sh` 的介面與 `commit`、`pr` 兩支技能的步驟，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。
How：三份只改 `version` 一個欄位，其餘內容不動，三份保持同一版號。
Who：`jsc-git` 外掛的套件描述檔。
|
2026-08-27 11:20:28 +08:00 |
|
|
jiantw83
|
7adee55dad
|
docs(git): README 補上 PR 階梯與兩支技能的新行為
What：README 新增「PR 階梯」一節（兩種型別的階梯表、多層子功能的推導方式、推不出就回 `7` 中止、功能主幹自動建立），工具表補上 `base-branch.sh --derive` 與 `slugify.sh` 連叫兩次組多層分支名，`commit` 與 `pr` 兩段說明改寫成新行為。
Why：階梯與校準是這次的行為變更，README 是對外說明。說明沒跟上，使用者會照舊以為 base 可以自己挑、PR 要重開一支。
How：階梯表在 README 只寫一份摘要，唯一來源仍是 `jsc-meta` 的 `references/guidelines.md`。技能說明兩段各補上推導與校準兩件事，用詞與 SKILL.md 一致。
Who：讀 `jsc-git` 說明的人，以及要接 `base-branch.sh` 的其他 domain。
|
2026-08-27 11:20:28 +08:00 |
|
|
jiantw83
|
82fb8077fc
|
feat(pr): 目標分支改走階梯，既有 PR 改為校準不重開
What：`pr` 技能新增「PR ladder」一節與階梯形狀的分支命名（`fix` 叫一次 `slugify.sh`，其餘型別叫兩次組出 `{類型}/{功能}/{子功能}`），base 一律由 `base-branch.sh --derive` 推導；新增步驟 6 查目標分支有沒有開啟中的 PR，有就跳到新的步驟 9 比對標題、描述、前置 PR 依賴三項，只有不一樣的那幾項才送 API。`commit` 技能新增步驟 5：認可完成後，目前分支已有 PR 就交給 `pr` 校準。
Why：越級開 PR 與「同一條分支重開第二支 PR」是同一個病灶的兩面——base 與 PR 現況都靠人記。改成先推導、先比對之後，base 由腳本決定，PR 只在真的有差時才更新。
How：呼叫方傳入的 base 仍然照收，但要與推導結果一致；不一致就當成越級擋下，說明正確階梯再問使用者，不會悄悄改目標。校準走 `jsc-gitea` 的 `pr-get` 讀現況、`pr-edit` 一次帶標題與描述、`pr-depend` 補依賴；三項都相同就什麼都不做——每一次多餘的編修都會通知所有審查者，安靜才是對的結果。
Who：`jsc-git:pr` 與 `jsc-git:commit` 兩支技能，以及呼叫它們的 `jsc-sdlc:implement`、`jsc-sdlc:maintain` 與 `jsc-meta` 各技能。
|
2026-08-27 11:20:28 +08:00 |
|
|
jiantw83
|
cc23722f31
|
feat(base-branch): 新增 --derive 從分支名推出階梯上一階
What：`tools/base-branch.sh` 新增 `--derive [分支]` 模式，從分支名推出唯一合法的上一階基底。`feat` 這一類走 `{類型}/{功能}/{子功能}` → `{類型}/{功能}/main` → `develop` → `master`，`fix` 走 `fix/{修改}` → `develop` → `master`。新增退出碼 `7`（推不出唯一合法基底）、`8`（推導出的基底不在遠端又不能自動建立）、`9`（自動建立功能主幹失敗）。既有的呼叫方模式一字未改。
Why：PR 階梯禁止越級，但基底原本靠呼叫端自己挑，挑錯就是把一個子功能直接併進 `develop`，中間那層功能主幹整個被跳過。判斷寫進程式，越級就不會發生在「這次剛好沒注意」的時候。
How：`{子功能}` 可以多層，推導一律把最後一段換成 `main`。推不出唯一合法基底就中止並回 `7`，由呼叫端問使用者，不猜、也不退回 `develop`——退回 `develop` 正是這支腳本要擋的那件事。功能主幹不在 origin 時，直接把 `origin/develop` 推成新分支自動補一條，不動本機工作區，再把建立了哪一條分支印到 stderr。分支名只收 ASCII 小寫、數字、連字號與斜線，中文簡述請先過 `tools/slugify.sh`。
Who：`jsc-git:pr` 決定 PR base 的那一步，以及所有經由它開 PR 的技能。
|
2026-08-27 11:20:27 +08:00 |
|