docs(models): 補上角色式模型路由文件與階段指定模型輸出表

What:references/model-tags.md 新增「階段指定模型(角色式路由)」章節,說明設定格式、檔案優先序與遞補鏈語意;skills/models/SKILL.md 的 description 與步驟加入 model-config.sh list 的「階段指定模型」輸出表(stage、指定鏈、source 三欄);README.md 補上 tools/model-config.sh 工具列與 models 技能說明。
Why:角色式模型路由需要文件明確定義設定格式與判定順序,jsc-sdlc 閘門與使用者才知道指定模型優先、標籤比對為備援。
How:設定格式 stage=model[,fallback...];優先序為專案 .jsc/models 覆寫 $JSC_HOME/models.conf;解析一律透過 jsc-cli/tools/model-config.sh,不自行讀檔;models 技能輸出表未設定的階段以「-」表示。
Who:models 技能的使用者與依賴模型閘門的 jsc-sdlc 各階段技能。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-24 11:36:45 +08:00
co-authored by Claude Fable 5
parent de504ee2ed
commit 072e01821b
3 changed files with 27 additions and 2 deletions
+23
View File
@@ -34,4 +34,27 @@
| 實作(implement) | coding |
| 維護(maintain) | 任意 |
## 階段指定模型(角色式路由)
每個 SDLC 階段可以指定一個模型,並附上遞補模型。設定格式一行一階段:
```
stage=model[,fallback1[,fallback2...]]
```
「#」開頭為註解,空白行忽略。階段限定 plan、analyze、implement、maintain。
設定檔位置與優先序:
| 順位 | 檔案 | 範圍 |
| --- | --- | --- |
| 1 | 專案目錄的 `.jsc/models` | 專案覆寫 |
| 2 | `$JSC_HOME/models.conf`(`JSC_HOME` 預設 `~/.jsc`) | 全域 |
專案檔有設定的階段完全覆寫全域設定;其餘階段仍讀全域檔。解析一律用 `jsc-cli/tools/model-config.sh`,不自行讀檔。
遞補鏈語意:鏈上第一個模型優先;前面的模型不可用時依序後退到下一個。
指定模型優先於標籤比對:階段有指定模型時直接用指定鏈;只有階段沒有指定模型時,才用上表的必要標籤判定。
表列以外的模型:依 `jsc-ask:ask` 規則詢問使用者或依供應商文件補表後再判定。