From 9377c2fbc7d871359fefa7a3705d0cea951a80f2 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 27 Aug 2026 16:34:16 +0800 Subject: [PATCH] =?UTF-8?q?feat(config-spec):=20=E8=A8=AD=E5=AE=9A?= =?UTF-8?q?=E8=A6=8F=E6=A0=BC=E8=A1=A8=E8=A3=9C=E4=B8=8A=E9=87=8D=E5=95=9F?= =?UTF-8?q?=E9=96=98=E9=96=80=E3=80=81=E5=85=A9=E4=BB=BD=E6=8C=87=E5=BC=95?= =?UTF-8?q?=E8=88=87=E5=9B=9B=E9=A0=85=E6=97=A2=E6=9C=89=E8=A8=AD=E5=AE=9A?= =?UTF-8?q?=E5=85=B1=E4=B9=9D=E5=88=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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` 的引導設定。 --- tools/config-spec.tsv | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/tools/config-spec.tsv b/tools/config-spec.tsv index d420437..5a961e1 100644 --- a/tools/config-spec.tsv +++ b/tools/config-spec.tsv @@ -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 殘留接線