docs(meta): 技能準則新增 PR 分支階梯與盯場輪詢間隔 #22

2026-08-27T03:20:55Z

jiantw83 commented

2026-08-27 03:20:55 +00:00

摘要

需求描述：落實「SDLC 執行流程」規則群裡的 PR 分支階梯，並把它寫成整個技能組的正本。階梯為 {類型}/{子功能} → {類型}/{功能}/main → develop → master，fix 走 fix/{修改} → develop → master，一律禁止越級。同時把 pr-watch.sh 的輪詢間隔變數登錄進環境變數表。決策紀錄在 wiki 存取庫 knowledges/QUESTION 的 QUESTION_FB8DF0B5，2026-08-27 那一節。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/guidelines.md`	階梯要對所有存取庫成立就必須有一份正本，否則各 domain 各寫一份，遲早互相打架。新增「PR 分支階梯」一節、環境變數表補 `JSC_PR_WATCH_INTERVAL`、稽核檢查清單新增「PR 的 base 沒有越級」一項
`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`	準則有異動就要 bump 版本，安裝端才拿得到新版；三份同步升到 0.1.3

設計重點

只寫規則，不寫實作。階梯一節寫表與六條說明，推導行為的正本仍在 jsc-git/tools/base-branch.sh；其他 domain 的 README 只寫摘要並指回這一節。
第 4 條把最容易走偏的那一步釘死：推不出唯一合法基底就中止並詢問使用者，不猜，也不退回 develop。退回 develop 就是讓子功能越級直接進主線。
第 6 條寫明階梯最後一級不能省。marketplace 與 version-guard.sh 讀的都是存取庫的預設分支，develop 沒併進 master 就等於沒有發布。
中文簡述先交給 jsc-git/tools/slugify.sh 轉 ASCII slug 再組分支名，與既有的「命名」第 5 條銜接，不重複寫字元限制。
稽核清單新增一項，越級開的 PR 才有一關會被發現；jsc-meta:skill-check 讀的正是這份清單。

測試結果

ste100-lint.sh .：全庫零命中。
三份 manifest 以 JSON 解析器讀過，格式正確且版本一致為 0.1.3。
階梯表的推導行為在 jsc-git 那一支 PR 用隔離的暫存存取庫實測過八種情境（含自動建立功能主幹、四種回 7 的情形與回 8 的情形），本節寫的規則與該實測結果一致。
未測：jsc-meta:skill-check 跑完整稽核，需要連得上 Gitea 正本 marketplace，本次在沒有 Gitea 存取的環境進行。

前置 Push Request

無

## 摘要 - 需求描述：落實「SDLC 執行流程」規則群裡的 PR 分支階梯，並把它寫成整個技能組的正本。階梯為 `{類型}/{子功能}` → `{類型}/{功能}/main` → `develop` → `master`，`fix` 走 `fix/{修改}` → `develop` → `master`，一律禁止越級。同時把 `pr-watch.sh` 的輪詢間隔變數登錄進環境變數表。決策紀錄在 wiki 存取庫 `knowledges/QUESTION` 的 `QUESTION_FB8DF0B5`，2026-08-27 那一節。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/guidelines.md` | 階梯要對所有存取庫成立就必須有一份正本，否則各 domain 各寫一份，遲早互相打架。新增「PR 分支階梯」一節、環境變數表補 `JSC_PR_WATCH_INTERVAL`、稽核檢查清單新增「PR 的 base 沒有越級」一項 | | `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` | 準則有異動就要 bump 版本，安裝端才拿得到新版；三份同步升到 0.1.3 | ## 設計重點 - 只寫規則，不寫實作。階梯一節寫表與六條說明，推導行為的正本仍在 `jsc-git/tools/base-branch.sh`；其他 domain 的 README 只寫摘要並指回這一節。 - 第 4 條把最容易走偏的那一步釘死：推不出唯一合法基底就中止並詢問使用者，不猜，也不退回 `develop`。退回 `develop` 就是讓子功能越級直接進主線。 - 第 6 條寫明階梯最後一級不能省。marketplace 與 `version-guard.sh` 讀的都是存取庫的預設分支，`develop` 沒併進 `master` 就等於沒有發布。 - 中文簡述先交給 `jsc-git/tools/slugify.sh` 轉 ASCII slug 再組分支名，與既有的「命名」第 5 條銜接，不重複寫字元限制。 - 稽核清單新增一項，越級開的 PR 才有一關會被發現；`jsc-meta:skill-check` 讀的正是這份清單。 ## 測試結果 - `ste100-lint.sh .`：全庫零命中。 - 三份 manifest 以 JSON 解析器讀過，格式正確且版本一致為 0.1.3。 - 階梯表的推導行為在 `jsc-git` 那一支 PR 用隔離的暫存存取庫實測過八種情境（含自動建立功能主幹、四種回 `7` 的情形與回 `8` 的情形），本節寫的規則與該實測結果一致。 - 未測：`jsc-meta:skill-check` 跑完整稽核，需要連得上 Gitea 正本 marketplace，本次在沒有 Gitea 存取的環境進行。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-27 03:20:56 +00:00

docs(guidelines): 準則新增 PR 分支階梯與盯場輪詢間隔 769d8f3f33

What：`references/guidelines.md` 新增「PR 分支階梯」一節，列出兩種型別的階梯、多層子功能的組法、base 一律由 `jsc-git/tools/base-branch.sh --derive` 推導、功能主幹自動建立，以及最後一級不能省；環境變數表補上 `JSC_PR_WATCH_INTERVAL`；稽核檢查清單新增一項「PR 的 base 符合 PR 分支階梯，沒有越級」。

Why：階梯要對所有存取庫成立，就必須有一份正本。放在技能準則裡，各 domain 的 README 與參考文件才能只寫摘要並指回來，不會養出好幾份互相打架的規則；稽核清單少了這一項，越級開的 PR 也沒有任何一關會發現。

How：階梯只寫表與六條說明，不寫實作細節，推導行為的正本仍在 `jsc-git/tools/base-branch.sh`。特別寫明第 4 條「推不出唯一合法基底就中止並詢問使用者，不猜，也不退回 `develop`」與第 6 條「`develop` 併進 `master` 才會生效」——marketplace 與 `version-guard.sh` 讀的都是存取庫的預設分支，階梯最後一級省掉就等於沒有發布。

Who：所有 jsc domain 存取庫的 PR，以及跑 `jsc-meta:skill-check` 稽核的人。

chore(manifest): 三份 manifest 版本升到 0.1.3 02b36a315c

What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.2 改為 0.1.3。

Why：技能準則新增了一節規則與一項稽核檢查，準則有異動就要 bump 版本，安裝端才拿得到新版。

How：三份只改 `version` 一個欄位，其餘內容不動，三份保持同一版號。

Who：`jsc-meta` 外掛的套件描述檔。

jiantw83 referenced this pull request from plugins/sdlc

2026-08-27 03:21:24 +00:00

feat(sdlc): 工作包隔離、留言取得共識後再修、盯 PR 到合併與每任務一筆日誌 #29

jiantw83 added a new dependency 2026-08-27 03:21:33 +00:00

plugins/sdlc#29 - feat(sdlc): 工作包隔離、留言取得共識後再修、盯 PR 到合併與每任務一筆日誌

admin merged commit 07d8583937 into feat/sdlc-flow-rules/main

2026-08-27 03:26:19 +00:00

admin deleted branch feat/sdlc-flow-rules/pr-ladder-guideline

2026-08-27 03:26:19 +00:00

jiantw83 referenced this pull request

2026-08-27 03:38:55 +00:00

docs(meta): 技能準則新增 PR 分支階梯與盯場輪詢間隔 #23