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 收尾。
60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# 執行環境體檢 — {hostname}/{使用者帳號}
|
||
|
||
> 由 `jsc-cli:doctor` 維護。這是體檢頁 `CHECK_{HASH}`，只保留最新一次結果，重跑就整頁覆寫。
|
||
> 修復請執行 `/jsc-cli:setup`，它讀這頁的「待修項目」逐項處理。
|
||
|
||
- 體檢時間：{yyyy-MM-dd HH:mm}
|
||
- 工作目錄：{絕對路徑}
|
||
- 執行 CLI：{claude、codex、copilot、antigravity、kiro 五選一}
|
||
|
||
## 結論
|
||
|
||
| 分類 | 通過 | 待修 | 略過 |
|
||
| --- | --- | --- | --- |
|
||
| 技能版本 | {n} | {n} | {n} |
|
||
| Hook 接線 | {n} | {n} | {n} |
|
||
| 全域設定 | {n} | {n} | {n} |
|
||
| 自我設定 | {n} | {n} | {n} |
|
||
|
||
## 技能版本
|
||
|
||
| Domain | 本機 | 遠端 | 狀態 |
|
||
| --- | --- | --- | --- |
|
||
| {domain} | {版本} | {版本} | {落後、最新、超前、查詢失敗、無法驗證} |
|
||
|
||
## Hook 接線
|
||
|
||
| CLI | 狀態 | 缺漏項目 | 說明 |
|
||
| --- | --- | --- | --- |
|
||
| {cli} | {wired、degraded、unwired、skipped} | {項目名，逗號分隔；無則寫「無」} | {降級原因或未偵測到執行檔} |
|
||
|
||
## 全域設定
|
||
|
||
| 項目 | 必要 | 現況 | 期望 | 修法 | 判定 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| {變數或檔案} | {是、否} | {實際值或未設定} | {該是什麼} | {自動、詢問、手動} | {通過、走預設、未設定、缺漏、設錯、略過} |
|
||
|
||
## 自我設定
|
||
|
||
> 工作目錄：{絕對路徑}
|
||
|
||
| 項目 | 必要 | 現況 | 期望 | 修法 | 判定 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| {變數或檔案} | {是、否} | {實際值或未設定} | {該是什麼} | {自動、詢問、手動} | {通過、走預設、未設定、缺漏、設錯、略過} |
|
||
|
||
## 待修項目
|
||
|
||
> `/jsc-cli:setup` 從這張表接手。沒有待修項目時整張表寫一列「無」。
|
||
|
||
| 順序 | 項目 | 範圍 | 判定 | 修法 | 影響 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| {n} | {變數、檔案、hook 或 domain} | {全域、自我} | {缺漏、設錯、未接線、落後} | {自動、詢問、手動} | {不修的話哪些技能跑不動} |
|
||
|
||
## 未登錄變數
|
||
|
||
> 原始碼有用到、`config-spec.tsv` 沒登錄的變數。體檢不判定它們，只提醒維護者補登錄。
|
||
|
||
| 變數 | 出現次數 |
|
||
| --- | --- |
|
||
| {變數名} | {n} |
|