Files
cli/templates/check-page.md
T
jiantw83 2adf9a172e feat(doctor): 新增執行環境體檢技能
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 收尾。
2026-08-26 10:43:37 +08:00

2.1 KiB
Raw Blame History

執行環境體檢 — {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}