feat(doctor): 加入 CLI 實測流程 #37

2026-08-28T08:24:17Z

jiantw83 commented

2026-08-28 08:24:17 +00:00

摘要

需求描述：更新 jsc-cli:doctor，加入實際 CLI、skill、hook 測試流程，透過 tools/test-clis.sh 找出環境問題。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`tools/test-clis.sh`	新增實測工具，輸出 `cli`、`skill`、`hook` 類型、每項測試與 summary。
`skills/doctor/SKILL.md`	將 doctor 從四項檢查改為五項檢查，納入 CLI、skill、hook runtime tests。
`templates/check-page.md`	新增 CLI 實測表的類型欄，讓待修項目可列 CLI、skill、hook 實測失敗。
`templates/check-contents.md`	新增 CLI 實測失敗統計欄位。
`README.md`	補上 `test-clis.sh` 用法、doctor 五項檢查與 `JSC_CLI_TEST_TIMEOUT`。
`.claude-plugin/plugin.json`	同步 plugin 版本。
`.codex-plugin/plugin.json`	同步 plugin 版本。
`plugin.json`	同步 plugin 版本。

設計重點

doctor 維持體檢角色，不改 CLI 設定。
test-clis.sh 跑 CLI 版本、說明頁與 plugin 清單。
test-clis.sh 檢查 doctor 的 SKILL.md 是否能從已安裝 plugin 定位。
test-clis.sh 透過 wire-cli.sh smoke {cli} 跑 hook 執行期測試。
fail 代表機器問題，包含 skill 與 hook 類型。
warn 代表功能降級，不一定列入待修。
skipped 代表沒有結論。

測試結果

sh -n tools/test-clis.sh 通過。
./tools/test-clis.sh 通過，摘要為 summary 23 1 1 0。
./tools/test-clis.sh claude 通過，摘要為 summary 5 0 0 0。
./tools/test-clis.sh invalid-cli 正確回用法錯誤，exit 2。
git diff --check 通過。
/root/plugins/meta/tools/ste100-lint.sh /root/plugins/cli 通過。
iconv -f UTF-8 -t UTF-8 驗證已改檔案為 UTF-8。
三份 manifest 已同步為 0.2.4。

前置 Push Request

無

## 摘要 - 需求描述：更新 `jsc-cli:doctor`，加入實際 CLI、skill、hook 測試流程，透過 `tools/test-clis.sh` 找出環境問題。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `tools/test-clis.sh` | 新增實測工具，輸出 `cli`、`skill`、`hook` 類型、每項測試與 summary。 | | `skills/doctor/SKILL.md` | 將 doctor 從四項檢查改為五項檢查，納入 CLI、skill、hook runtime tests。 | | `templates/check-page.md` | 新增 CLI 實測表的類型欄，讓待修項目可列 CLI、skill、hook 實測失敗。 | | `templates/check-contents.md` | 新增 CLI 實測失敗統計欄位。 | | `README.md` | 補上 `test-clis.sh` 用法、doctor 五項檢查與 `JSC_CLI_TEST_TIMEOUT`。 | | `.claude-plugin/plugin.json` | 同步 plugin 版本。 | | `.codex-plugin/plugin.json` | 同步 plugin 版本。 | | `plugin.json` | 同步 plugin 版本。 | ## 設計重點 - doctor 維持體檢角色，不改 CLI 設定。 - `test-clis.sh` 跑 CLI 版本、說明頁與 plugin 清單。 - `test-clis.sh` 檢查 `doctor` 的 SKILL.md 是否能從已安裝 plugin 定位。 - `test-clis.sh` 透過 `wire-cli.sh smoke {cli}` 跑 hook 執行期測試。 - `fail` 代表機器問題，包含 `skill` 與 `hook` 類型。 - `warn` 代表功能降級，不一定列入待修。 - `skipped` 代表沒有結論。 ## 測試結果 - `sh -n tools/test-clis.sh` 通過。 - `./tools/test-clis.sh` 通過，摘要為 `summary 23 1 1 0`。 - `./tools/test-clis.sh claude` 通過，摘要為 `summary 5 0 0 0`。 - `./tools/test-clis.sh invalid-cli` 正確回用法錯誤，exit `2`。 - `git diff --check` 通過。 - `/root/plugins/meta/tools/ste100-lint.sh /root/plugins/cli` 通過。 - `iconv -f UTF-8 -t UTF-8` 驗證已改檔案為 UTF-8。 - 三份 manifest 已同步為 `0.2.4`。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-28 08:24:17 +00:00

feat(doctor): 加入 CLI 實測流程 0b2c7b13a0

chore(manifest): bump jsc-cli to 0.2.3 bfd01f71c4

jiantw83 added 2 commits 2026-08-28 08:31:07 +00:00

feat(doctor): 納入 skill 與 hook 實測 f7be015934

chore(manifest): bump jsc-cli to 0.2.4 12d8d7107c

admin approved these changes 2026-08-28 09:00:33 +00:00

admin merged commit 7e47931b5c into feat/doctor-cli-runtime-tests/main

2026-08-28 09:00:42 +00:00

admin deleted branch feat/doctor-cli-runtime-tests/add-executable-checks

2026-08-28 09:00:42 +00:00

Sign in to join this conversation.