jiantw83
98781a331f
What：`tools/deploy.sh` 的 `restart` 那一行改印 `$JSC_HOME/restart-required.d/{CLI 代號}`，檔頭註解一併改寫成「轉呼叫 `restart-gate.sh require` 掛上這支 CLI 的閘門」。`tools/write-guides.sh` 產生的更新指引，狀態檔說明改成一支 CLI 一份、重啟只清自己那份、別支的閘門不受影響。`tools/config-spec.tsv` 的 `$JSC_HOME/restart-required` 那一列改成 `$JSC_HOME/restart-required.d` 目錄，說明改為「該 CLI 那份不存在代表這支沒有待重啟的部署」。
Why：`jsc-hooks` 這一輪把狀態檔改成一支 CLI 一份，路徑從單一檔案變成狀態目錄底下的一份。`deploy.sh` 印的是操作者接下來要看的檔案路徑，印錯就指向一個不存在的檔案；`write-guides.sh` 寫出的更新指引是下一輪部署的依據，留著舊路徑會讓人以為刪掉那個檔案就能解除閘門；`config-spec.tsv` 是 `/jsc-cli:doctor` 比對設定落點的依據，路徑對不上就查不到這份執行期暫態。
How：三處都只跟著改路徑與說明，掛閘門的動作本來就是轉呼叫 `jsc-hooks` 的 `restart-gate.sh require`，這裡不重寫一份判定，也不自己組狀態檔內容——路徑與格式的唯一來源留在 `restart-gate.sh`。`config-spec.tsv` 那一列的型別仍是 `global` 的執行期暫態、備份與還原都維持 `none`，欄位數不變。
Who：`jsc-cli:deploy` 的部署收尾與更新指引，對齊 `jsc-hooks` 一支 CLI 一份的重啟狀態檔。
7.8 KiB
7.8 KiB
| 1 | # config-spec.tsv — jsc 技能組的設定規格表。體檢（/jsc-cli:doctor）與設定（/jsc-cli:setup）共用這一份。 | |||||||
|---|---|---|---|---|---|---|---|---|
| 2 | # | |||||||
| 3 | # 這張表是「必要或選擇」的唯一判準。掃描原始碼分不出必要與選擇，也分不出哪些是執行期內部 | |||||||
| 4 | # 變數，所以判準用手寫規格表，掃描只負責抓出漏登錄的項目（scan-config.sh orphans）。 | |||||||
| 5 | # 新增環境變數或設定檔時，同時補一列進來，體檢才看得到它。 | |||||||
| 6 | # | |||||||
| 7 | # 欄位：key<TAB>kind<TAB>scope<TAB>required<TAB>default<TAB>verify<TAB>fix<TAB>desc | |||||||
| 8 | # kind env=環境變數 file=檔案或目錄 internal=執行期內部變數（體檢略過，只為登錄而存在） | |||||||
| 9 | # scope global=整台機器 project=當前工作目錄 runtime=hook 執行當下才存在 | |||||||
| 10 | # required yes=缺了就有技能跑不動 no=選擇性，缺了走預設或降級 | |||||||
| 11 | # default 未設定時的實際值；沒有預設寫 - | |||||||
| 12 | # verify set=有值即可 dir=目錄要在 file=檔案要在 gitea-api=站台連得上 | |||||||
| 13 | # gitea-auth=認證過得了 wiki-repo=值可解析成 {owner}/{repo} none=不驗 | |||||||
| 14 | # fix auto=工具算得出，可直接寫入 ask=值要人給，問完才寫 manual=只能人手動處理 -=不需修 | |||||||
| 15 | # desc 一句繁中說明，直接印給使用者看 | |||||||
| 16 | # | |||||||
| 17 | GITEA_HOST | env | global | yes | - | gitea-api | ask | Gitea 站台位址，所有 wiki 與 PR 操作的去處 |
| 18 | GITEA_TOKEN | env | global | yes | - | gitea-auth | ask | Gitea API token；未設定時退回 tea CLI 的登入金鑰 |
| 19 | JSC_HOME | env | global | no | ~/.jsc | dir | auto | hook 資料目錄，放工作階段計時、用量統計、版本快取 |
| 20 | JSC_WIKI_REPO | env | global | no | - | wiki-repo | ask | 未逐類設定時的共用 wiki {owner}/{repo} |
| 21 | JSC_WIKI_REPO_QUESTION | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | QUESTION_CONTENTS、QUESTION_{HASH} 所在存取庫 |
| 22 | JSC_WIKI_REPO_PLAN | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | PLAN_CONTENTS、PLAN_{HASH} 所在存取庫 |
| 23 | JSC_WIKI_REPO_ANALYZE | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | ANALYZE_CONTENTS、ANALYZE_{HASH} 所在存取庫 |
| 24 | JSC_WIKI_REPO_DELIVER | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | DELIVER_CONTENTS、DELIVER_{HASH} 所在存取庫 |
| 25 | JSC_WIKI_REPO_MAINTAIN | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | MAINTAIN_CONTENTS、MAINTAIN_{HASH} 所在存取庫 |
| 26 | JSC_WIKI_REPO_REPO | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | REPO_CONTENTS、REPO_{HASH} 所在存取庫 |
| 27 | JSC_WIKI_REPO_LOG | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | LOG_CONTENTS、LOG_{HASH} 所在存取庫 |
| 28 | JSC_WIKI_REPO_LEARN | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | LEARN_CONTENTS、LEARN_{HASH} 所在存取庫 |
| 29 | JSC_WIKI_REPO_ERROR | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | ERROR_CONTENTS、ERROR_{HASH} 所在存取庫 |
| 30 | JSC_WIKI_REPO_CHECK | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | CHECK_CONTENTS、CHECK_{HASH} 所在存取庫，體檢紀錄寫在這裡 |
| 31 | JSC_WIKI_REPO_REPORT | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | REPORT_CONTENTS、REPORT_{HASH} 所在存取庫，年月週日報表寫在這裡 |
| 32 | JSC_VERSION_GUARD | env | global | no | on | set | ask | 設成 off 可完全略過版本前置檢查，離線工作時用 |
| 33 | JSC_VERSION_TTL | env | global | no | 600 | set | ask | 版本查詢快取秒數 |
| 34 | JSC_RESTART_GATE | env | global | no | on | set | ask | 設成 off 可略過部署後的重啟提示閘門，判讀在 jsc-hooks |
| 35 | JSC_WIKI_REPO_SKILLSET | env | global | no | JSC_WIKI_REPO | wiki-repo | ask | SKILLSET_CONTENTS、SKILLSET_{HASH} 所在的 {owner}/{repo}，技能組異動報告寫在這裡 |
| 36 | JSC_LANG_GUARD | env | global | no | on | set | ask | 設成 off 可關閉繁中編碼與簡體字守門，誤判時用 |
| 37 | JSC_COMMENT_SCOPE | env | global | no | on | set | ask | 設成 off 可關閉註解夾帶文件編號的守門，誤判時用 |
| 38 | JSC_CHANGED_FILE | internal | runtime | no | - | none | - | 非 Claude CLI 傳入的變更檔路徑，註解範圍與繁中編碼守門讀它 |
| 39 | JSC_SIMPLIFIED_FILE | internal | runtime | no | - | none | - | 自訂簡體字表路徑，ste100-lint.sh 讀它取代內建字表 |
| 40 | JSC_PR_WATCH_INTERVAL | env | global | no | 60 | set | ask | pr-watch.sh 輪詢 PR 狀態的間隔秒數，實作在 jsc-gitea/tools/pr-watch.sh |
| 41 | JSC_LOCAL_PLUGINS | env | global | no | $JSC_HOME/plugins | dir | auto | antigravity 安裝來源的本地 plugin 目錄 |
| 42 | JSC_PLUGINS_ROOT | env | global | no | - | dir | ask | 技能組工作目錄根位置，jsc-meta 的工具用它找各 domain |
| 43 | JSC_CLAUDE_SETTINGS_DIR | env | global | no | ~/.claude | dir | ask | claude 使用者層設定檔目錄，測試 purge 時才需覆寫 |
| 44 | JSC_COPILOT_INSTRUCTIONS | env | global | no | ~/.config/copilot/copilot-instructions.md | file | ask | copilot 指引檔位置，STE100 規則段落寫在這裡 |
| 45 | JSC_ANTIGRAVITY_RULES | env | global | no | ~/.antigravity/AGENTS.md | file | ask | antigravity 全域規則檔位置 |
| 46 | JSC_KIRO_SKILLS | env | global | no | - | dir | ask | kiro 技能目錄，接線與部署都會用到 |
| 47 | JSC_GITEA_TOOLS | env | global | no | - | dir | ask | jsc-gitea/tools 的位置，跨 domain 呼叫 gitea.sh 時用 |
| 48 | $JSC_HOME/model-tags.tsv | file | global | yes | - | file | auto | SDLC 階段閘門讀的能力標籤表，由 /jsc-cli:models 產生 |
| 49 | $JSC_HOME/models.conf | file | global | no | - | file | ask | 各 SDLC 階段的偏好模型鏈，專案 .jsc/models 可覆寫 |
| 50 | $JSC_HOME/html-styles.conf | file | global | no | - | file | ask | 各類頁面的 HTML 匯出版型與樣式，專案 .jsc/html-styles 可覆寫 |
| 51 | $JSC_HOME/update-guide.md | file | global | no | - | file | manual | 這台機器的更新指引，由 jsc-cli/tools/write-guides.sh 產生；缺了就重跑 /jsc-cli:deploy |
| 52 | $JSC_HOME/remove-guide.md | file | global | no | - | file | manual | 這台機器的移除指引，由 jsc-cli/tools/write-guides.sh 產生；缺了就重跑 /jsc-cli:deploy |
| 53 | $JSC_HOME/restart-required.d | file | global | no | - | none | - | 部署收尾寫下的重啟狀態檔目錄，一支 CLI 一份，執行期暫態；該 CLI 那份不存在代表這支沒有待重啟的部署，jsc-hooks 讀它提示重啟 |
| 54 | .jsc/models | file | project | no | - | file | ask | 本專案的 SDLC 偏好模型鏈，覆寫 $JSC_HOME/models.conf |
| 55 | .jsc/html-styles | file | project | no | - | file | ask | 本專案的 HTML 匯出版型與樣式，覆寫 $JSC_HOME/html-styles.conf |
| 56 | .claude/settings.json | file | project | no | - | file | manual | claude 的專案層設定；jsc hook 由 plugin 的 hooks.json 接線，這裡不該有 jsc 殘留接線 |
| 57 | AGENTS.md | file | project | no | - | file | manual | codex 與 antigravity 讀的專案層指引檔 |
| 58 | .env | file | project | no | - | none | manual | 專案層環境變數；覆寫全域設定時，體檢會標出實際生效值 |
| 59 | .envrc | file | project | no | - | none | manual | direnv 設定檔；覆寫全域設定時，體檢會標出實際生效值 |
| 60 | JSC_CLI | internal | runtime | no | - | none | - | 接線時帶入的 CLI 代號，hook 用來分辨宿主 |
| 61 | JSC_SKILL | internal | runtime | no | - | none | - | 目前呼叫的技能名，版本前置檢查與用量統計用 |
| 62 | JSC_SESSION_ID | internal | runtime | no | - | none | - | 工作階段代號，計時與 token 統計用 |
| 63 | JSC_TOOL_NAME | internal | runtime | no | - | none | - | 目前的工具名，PreToolUse hook 用來比對 matcher |
| 64 | JSC_SCRIPT_DIR | internal | runtime | no | - | none | - | 呼叫端腳本所在目錄，由 lib.sh 算出 |
| 65 | JSC_HOOKS_DIR | internal | runtime | no | - | none | - | hooks 目錄位置，包裝啟動器用 |
| 66 | JSC_MODEL | internal | runtime | no | - | none | - | 目前模型 id，SDLC 閘門用來比對能力標籤 |
| 67 | JSC_GITEA_OWNER | internal | runtime | no | - | none | - | 批次同步存取庫時鎖定的 owner |
| 68 | JSC_DEPLOY_DRYRUN | internal | runtime | no | - | none | - | 部署試跑旗標，只印指令不執行 |
| 69 | JSC_WP_GATE | internal | runtime | no | - | none | - | 工作包閘門的逃生門，實作在 jsc-sdlc/tools/wp-gate.sh |
| 70 | JSC_CONFIG_SPEC | internal | runtime | no | - | none | - | 改讀別份設定規格表，測試 scan-config.sh 時用 |
| 71 | JSC_SYNC_DRY_RUN | internal | runtime | no | - | none | - | 同步 domain 存取庫的試跑旗標，只印不動檔案 |
| 72 | JSC_MK_DOMAIN | internal | runtime | no | - | none | - | sync-marketplace.sh 傳給 python 的 domain 名 |
| 73 | JSC_MK_URL | internal | runtime | no | - | none | - | sync-marketplace.sh 傳給 python 的存取庫網址 |
| 74 | JSC_MK_DESC | internal | runtime | no | - | none | - | sync-marketplace.sh 傳給 python 的 plugin 描述 |
| 75 | JSC_MK_IN | internal | runtime | no | - | none | - | sync-marketplace.sh 讀入的 marketplace 檔路徑 |
| 76 | JSC_MK_OUT | internal | runtime | no | - | none | - | sync-marketplace.sh 寫出的 marketplace 檔路徑 |