jiantw83
2adf9a172e
What: 新增 jsc-cli:doctor，一次體檢技能版本、Hook 接線、全域設定與自我設定，只讀不改，結果寫進 wiki CHECK_{HASH}。
Why: 安裝或更新技能組之後，沒有任何工具說得出這台機器還缺什麼。設定散在環境變數、rc 檔與專案目錄，出錯時只能一個一個猜。
How: 版本比對複用 jsc-hooks 的 version-guard.sh report，接線狀態複用新加的 wire-cli.sh status（唯讀），設定則由 tools/scan-config.sh 比對 tools/config-spec.tsv 判定必要或選擇。規格表是必要性的唯一判準，掃描只負責抓出漏登錄的變數。
Who: 體檢與修復流程，搭配 jsc-cli:setup 收尾。
6.5 KiB
6.5 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_LOCAL_PLUGINS | env | global | no | $JSC_HOME/plugins | dir | auto | antigravity 安裝來源的本地 plugin 目錄 |
| 35 | JSC_PLUGINS_ROOT | env | global | no | - | dir | ask | 技能組工作目錄根位置，jsc-meta 的工具用它找各 domain |
| 36 | JSC_CLAUDE_SETTINGS_DIR | env | global | no | ~/.claude | dir | ask | claude 使用者層設定檔目錄，測試 purge 時才需覆寫 |
| 37 | JSC_COPILOT_INSTRUCTIONS | env | global | no | ~/.config/copilot/copilot-instructions.md | file | ask | copilot 指引檔位置，STE100 規則段落寫在這裡 |
| 38 | JSC_ANTIGRAVITY_RULES | env | global | no | ~/.antigravity/AGENTS.md | file | ask | antigravity 全域規則檔位置 |
| 39 | JSC_KIRO_SKILLS | env | global | no | - | dir | ask | kiro 技能目錄，接線與部署都會用到 |
| 40 | JSC_GITEA_TOOLS | env | global | no | - | dir | ask | jsc-gitea/tools 的位置，跨 domain 呼叫 gitea.sh 時用 |
| 41 | $JSC_HOME/model-tags.tsv | file | global | yes | - | file | auto | SDLC 階段閘門讀的能力標籤表，由 /jsc-cli:models 產生 |
| 42 | $JSC_HOME/models.conf | file | global | no | - | file | ask | 各 SDLC 階段的偏好模型鏈，專案 .jsc/models 可覆寫 |
| 43 | $JSC_HOME/html-styles.conf | file | global | no | - | file | ask | 各類頁面的 HTML 匯出版型與樣式，專案 .jsc/html-styles 可覆寫 |
| 44 | .jsc/models | file | project | no | - | file | ask | 本專案的 SDLC 偏好模型鏈，覆寫 $JSC_HOME/models.conf |
| 45 | .jsc/html-styles | file | project | no | - | file | ask | 本專案的 HTML 匯出版型與樣式，覆寫 $JSC_HOME/html-styles.conf |
| 46 | .claude/settings.json | file | project | no | - | file | manual | claude 的專案層設定；jsc hook 由 plugin 的 hooks.json 接線，這裡不該有 jsc 殘留接線 |
| 47 | AGENTS.md | file | project | no | - | file | manual | codex 與 antigravity 讀的專案層指引檔 |
| 48 | .env | file | project | no | - | none | manual | 專案層環境變數；覆寫全域設定時，體檢會標出實際生效值 |
| 49 | .envrc | file | project | no | - | none | manual | direnv 設定檔；覆寫全域設定時，體檢會標出實際生效值 |
| 50 | JSC_CLI | internal | runtime | no | - | none | - | 接線時帶入的 CLI 代號，hook 用來分辨宿主 |
| 51 | JSC_SKILL | internal | runtime | no | - | none | - | 目前呼叫的技能名，版本前置檢查與用量統計用 |
| 52 | JSC_SESSION_ID | internal | runtime | no | - | none | - | 工作階段代號，計時與 token 統計用 |
| 53 | JSC_TOOL_NAME | internal | runtime | no | - | none | - | 目前的工具名，PreToolUse hook 用來比對 matcher |
| 54 | JSC_SCRIPT_DIR | internal | runtime | no | - | none | - | 呼叫端腳本所在目錄，由 lib.sh 算出 |
| 55 | JSC_HOOKS_DIR | internal | runtime | no | - | none | - | hooks 目錄位置，包裝啟動器用 |
| 56 | JSC_MODEL | internal | runtime | no | - | none | - | 目前模型 id，SDLC 閘門用來比對能力標籤 |
| 57 | JSC_GITEA_OWNER | internal | runtime | no | - | none | - | 批次同步存取庫時鎖定的 owner |
| 58 | JSC_DEPLOY_DRYRUN | internal | runtime | no | - | none | - | 部署試跑旗標，只印指令不執行 |
| 59 | JSC_WP_GATE | internal | runtime | no | - | none | - | 工作包閘門的逃生門，實作在 jsc-sdlc/tools/wp-gate.sh |
| 60 | JSC_CONFIG_SPEC | internal | runtime | no | - | none | - | 改讀別份設定規格表，測試 scan-config.sh 時用 |
| 61 | JSC_SYNC_DRY_RUN | internal | runtime | no | - | none | - | 同步 domain 存取庫的試跑旗標，只印不動檔案 |
| 62 | JSC_MK_DOMAIN | internal | runtime | no | - | none | - | sync-marketplace.sh 傳給 python 的 domain 名 |
| 63 | JSC_MK_URL | internal | runtime | no | - | none | - | sync-marketplace.sh 傳給 python 的存取庫網址 |
| 64 | JSC_MK_DESC | internal | runtime | no | - | none | - | sync-marketplace.sh 傳給 python 的 plugin 描述 |
| 65 | JSC_MK_IN | internal | runtime | no | - | none | - | sync-marketplace.sh 讀入的 marketplace 檔路徑 |
| 66 | JSC_MK_OUT | internal | runtime | no | - | none | - | sync-marketplace.sh 寫出的 marketplace 檔路徑 |