feat(config-spec): 設定規格表補上重啟閘門、兩份指引與四項既有設定共九列

What:`tools/config-spec.tsv` 新增九列。這次新增的五項:`JSC_RESTART_GATE`、`JSC_WIKI_REPO_SKILLSET`、`$JSC_HOME/update-guide.md`、`$JSC_HOME/remove-guide.md`、`$JSC_HOME/restart-required`;補登既有但漏列的四項:`JSC_LANG_GUARD`、`JSC_COMMENT_SCOPE`、`JSC_CHANGED_FILE`、`JSC_SIMPLIFIED_FILE`。

Why:這一份是體檢與設定共用的唯一規格表,`scan-config.sh` 與 `/jsc-cli:doctor` 都讀它。沒登錄的設定項體檢查不到,等於機器上有一批設定沒人管;`orphans` 那一側也對不起來。準則寫的「新增設定時要同步補一列」就是為了這件事。

How:兩份指引標 `manual`,缺了就重跑 `/jsc-cli:deploy`,不由體檢自動補。`$JSC_HOME/restart-required` 與 `JSC_CHANGED_FILE`、`JSC_SIMPLIFIED_FILE` 都是執行期暫態,驗證與修法欄一律標 `none` 與 `-`:不存在是正常狀態,標成必要項會讓體檢把「沒有待重啟的部署」誤判成缺失。三個 `off` 開關(`JSC_RESTART_GATE`、`JSC_LANG_GUARD`、`JSC_COMMENT_SCOPE`)預設值一律寫 `on`,說明欄講明什麼情況才關。九列的欄位數與既有列一致為 8 欄。

Who:`scan-config.sh`、`/jsc-cli:doctor` 的執行環境體檢與 `/jsc-cli:setup` 的引導設定。
This commit is contained in:
2026-08-27 16:34:16 +08:00
parent eca467696f
commit 9377c2fbc7
+9
View File
@@ -31,6 +31,12 @@ JSC_WIKI_REPO_CHECK env global no JSC_WIKI_REPO wiki-repo ask CHECK_CONTENTS、C
JSC_WIKI_REPO_REPORT env global no JSC_WIKI_REPO wiki-repo ask REPORT_CONTENTS、REPORT_{HASH} 所在存取庫,年月週日報表寫在這裡
JSC_VERSION_GUARD env global no on set ask 設成 off 可完全略過版本前置檢查,離線工作時用
JSC_VERSION_TTL env global no 600 set ask 版本查詢快取秒數
JSC_RESTART_GATE env global no on set ask 設成 off 可略過部署後的重啟提示閘門,判讀在 jsc-hooks
JSC_WIKI_REPO_SKILLSET env global no JSC_WIKI_REPO wiki-repo ask SKILLSET_CONTENTS、SKILLSET_{HASH} 所在的 {owner}/{repo},技能組異動報告寫在這裡
JSC_LANG_GUARD env global no on set ask 設成 off 可關閉繁中編碼與簡體字守門,誤判時用
JSC_COMMENT_SCOPE env global no on set ask 設成 off 可關閉註解夾帶文件編號的守門,誤判時用
JSC_CHANGED_FILE internal runtime no - none - 非 Claude CLI 傳入的變更檔路徑,註解範圍與繁中編碼守門讀它
JSC_SIMPLIFIED_FILE internal runtime no - none - 自訂簡體字表路徑,ste100-lint.sh 讀它取代內建字表
JSC_PR_WATCH_INTERVAL env global no 60 set ask pr-watch.sh 輪詢 PR 狀態的間隔秒數,實作在 jsc-gitea/tools/pr-watch.sh
JSC_LOCAL_PLUGINS env global no $JSC_HOME/plugins dir auto antigravity 安裝來源的本地 plugin 目錄
JSC_PLUGINS_ROOT env global no - dir ask 技能組工作目錄根位置,jsc-meta 的工具用它找各 domain
@@ -42,6 +48,9 @@ JSC_GITEA_TOOLS env global no - dir ask jsc-gitea/tools 的位置,跨 domain
$JSC_HOME/model-tags.tsv file global yes - file auto SDLC 階段閘門讀的能力標籤表,由 /jsc-cli:models 產生
$JSC_HOME/models.conf file global no - file ask 各 SDLC 階段的偏好模型鏈,專案 .jsc/models 可覆寫
$JSC_HOME/html-styles.conf file global no - file ask 各類頁面的 HTML 匯出版型與樣式,專案 .jsc/html-styles 可覆寫
$JSC_HOME/update-guide.md file global no - file manual 這台機器的更新指引,由 jsc-cli/tools/write-guides.sh 產生;缺了就重跑 /jsc-cli:deploy
$JSC_HOME/remove-guide.md file global no - file manual 這台機器的移除指引,由 jsc-cli/tools/write-guides.sh 產生;缺了就重跑 /jsc-cli:deploy
$JSC_HOME/restart-required file global no - none - 部署收尾寫下的重啟狀態檔,執行期暫態;不存在代表沒有待重啟的部署,jsc-hooks 讀它提示重啟
.jsc/models file project no - file ask 本專案的 SDLC 偏好模型鏈,覆寫 $JSC_HOME/models.conf
.jsc/html-styles file project no - file ask 本專案的 HTML 匯出版型與樣式,覆寫 $JSC_HOME/html-styles.conf
.claude/settings.json file project no - file manual claude 的專案層設定;jsc hook 由 plugin 的 hooks.json 接線,這裡不該有 jsc 殘留接線
1 # config-spec.tsv — jsc 技能組的設定規格表。體檢(/jsc-cli:doctor)與設定(/jsc-cli:setup)共用這一份。
31 JSC_WIKI_REPO_REPORT
32 JSC_VERSION_GUARD
33 JSC_VERSION_TTL
34 JSC_RESTART_GATE
35 JSC_WIKI_REPO_SKILLSET
36 JSC_LANG_GUARD
37 JSC_COMMENT_SCOPE
38 JSC_CHANGED_FILE
39 JSC_SIMPLIFIED_FILE
40 JSC_PR_WATCH_INTERVAL
41 JSC_LOCAL_PLUGINS
42 JSC_PLUGINS_ROOT
48 $JSC_HOME/model-tags.tsv
49 $JSC_HOME/models.conf
50 $JSC_HOME/html-styles.conf
51 $JSC_HOME/update-guide.md
52 $JSC_HOME/remove-guide.md
53 $JSC_HOME/restart-required
54 .jsc/models
55 .jsc/html-styles
56 .claude/settings.json