feat(git-safety,model): 分支一律先確認、模型 id 改以 transcript 實際值為準 #13

2026-08-24T09:26:26Z

jiantw83 commented

2026-08-24 09:26:26 +00:00

變更摘要

兩份共用規範補上先前缺的內容。

一、spec-git-safety 新增「分支一律先跟使用者確認」

分析既有程式碼前確認來源分支（讀任何程式碼之前）；實作、修改程式碼前確認目標分支（寫任何檔案之前）。
不得從目前 checkout 的分支推定使用者意圖，也不得靜默預設 develop／master。
只讀取的階段不代為切換分支：需要換分支才能讀到正確現況時，停下來請使用者處理，不 switch、不 stash、不動工作區。
確認結果寫進該 skill 的產出（分析頁的來源分支欄、PR 的目標分支），後續一律沿用同一個答案。

二、spec-model 改寫「取得當前模型 id」

原本寫「只能以 agent 自我回報為準」，那讓所有模型閘門形同虛設。改為明確的優先序：

transcript 記錄的實際值（hook 的 transcript_path jsonl，尾端 assistant 訊息的 model）——唯一可驗證的來源，SDLC 階段閘門一律以它為準。
stdin JSON 的 model、JSC_MODEL、~/.claude/settings.json——都是宣告值，未必等於實際跑的模型。
自我回報只在以上都取不到時當最後手段，且不得作為放行依據。

另補上「強制力落在程式層」原則，以及本規範中文標籤與 jsc-cli/references/model-tags.md 英文標籤（reasoning-max 等）的對應表。

影響範圍

jsc-sdlc 的 analyze／implement 已引用分支確認規範（該 repo 另有 PR）。
jsc-hooks 的 sdlc-gate.sh 已依 transcript 優先序實作（已發佈）。
兩節都是補充既有規範，不推翻原有條款。

風險與注意事項

新增或改名任一邊的標籤時，中文標籤與英文標籤的對應表要同步，否則閘門判定與選型說明會不一致。

驗證

STE100 lint 通過。

## 變更摘要兩份共用規範補上先前缺的內容。 **一、`spec-git-safety` 新增「分支一律先跟使用者確認」** - 分析既有程式碼前確認**來源分支**（讀任何程式碼之前）；實作、修改程式碼前確認**目標分支**（寫任何檔案之前）。 - 不得從目前 checkout 的分支推定使用者意圖，也不得靜默預設 `develop`／`master`。 - 只讀取的階段不代為切換分支：需要換分支才能讀到正確現況時，停下來請使用者處理，不 `switch`、不 `stash`、不動工作區。 - 確認結果寫進該 skill 的產出（分析頁的來源分支欄、PR 的目標分支），後續一律沿用同一個答案。 **二、`spec-model` 改寫「取得當前模型 id」** 原本寫「只能以 agent 自我回報為準」，那讓所有模型閘門形同虛設。改為明確的優先序： 1. **transcript 記錄的實際值**（hook 的 `transcript_path` jsonl，尾端 assistant 訊息的 `model`）——唯一可驗證的來源，SDLC 階段閘門一律以它為準。 2. stdin JSON 的 `model`、`JSC_MODEL`、`~/.claude/settings.json`——都是宣告值，未必等於實際跑的模型。 3. **自我回報只在以上都取不到時當最後手段**，且**不得作為放行依據**。另補上「強制力落在程式層」原則，以及本規範中文標籤與 `jsc-cli/references/model-tags.md` 英文標籤（`reasoning-max` 等）的對應表。 ## 影響範圍 - `jsc-sdlc` 的 `analyze`／`implement` 已引用分支確認規範（該 repo 另有 PR）。 - `jsc-hooks` 的 `sdlc-gate.sh` 已依 transcript 優先序實作（已發佈）。 - 兩節都是補充既有規範，不推翻原有條款。 ## 風險與注意事項新增或改名任一邊的標籤時，中文標籤與英文標籤的對應表要同步，否則閘門判定與選型說明會不一致。 ## 驗證 STE100 lint 通過。

jiantw83 added 9 commits 2026-08-24 09:26:27 +00:00

Merge pull request 'chore(plugin 版本): 三家 manifest 升版 0.1.4' (#6 ) from develop into master aaddbe3215

Reviewed-on: #6

Merge pull request 'chore(plugin 版本): 三家 manifest 升版 0.1.5' (#7 ) from develop into master 9ffb800b09

Reviewed-on: #7
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

Merge pull request 'refactor(spec-wiki-contents): 目錄頁改依系統分段六欄表格' (#8 ) from develop into master eed0a6190a

Reviewed-on: #8
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

Merge pull request 'feat(spec-version-guard): 新增版本前置檢查規範、腳本與 hook' (#9 ) from develop into master df2f177520

Reviewed-on: #9
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

Merge pull request 'refactor(spec-wiki-contents): 目錄頁 check 欄改用 ●／○' (#10 ) from develop into master bb7b641261

Reviewed-on: #10
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

Merge pull request 'feat(todo-wiki,do-wiki): checklist 依群組分組、do-wiki 改以工作證逐群組領取' (#11 ) from develop into master fcea8ee48c

Reviewed-on: #11
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

Merge pull request 'fix(version-guard): 遠端版本查詢加上重試，避免暫時性網路失敗誤判 fail-closed' (#12 ) from develop into master ca53be3011

Reviewed-on: #12
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

feat(git-safety,model): 分支一律先確認、模型 id 改以 transcript 實際值為準 20cc363c23

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

chore(plugin 版本): 三份 manifest 升版至 0.2.5 f22b18bf5c

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

jiantw83 added a new dependency 2026-08-24 09:26:37 +00:00

plugins/sdlc#8 - feat(交付與共識): 交付工作包獨立為 WP-01、新增交付內容型別與共識判定規則

jiantw83 removed a dependency 2026-08-24 09:37:24 +00:00

plugins/sdlc#8 - feat(交付與共識): 交付工作包獨立為 WP-01、新增交付內容型別與共識判定規則

jiantw83 closed this pull request

2026-08-24 09:37:41 +00:00

Pull request closed

Please reopen this pull request to perform a merge.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/shared#13