 jiantw83
|
0f9aeefead
|
chore(manifest): 三份 manifest 版本升到 0.1.9
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.8 改為 0.1.9。
Why：本次新增 `write-guides.sh`、`deploy.sh` 收尾多掛一道重啟閘門、`deploy` 技能多兩個步驟，設定規格表也多九列，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。
How：三份只改 `version` 一個欄位，其餘內容不動，三份保持同一版號。
Who：`jsc-cli` 外掛的套件描述檔。
|
2026-08-27 16:34:17 +08:00 |
|
|
jiantw83
|
afc4c5b50a
|
docs(cli): README 補上兩份指引、重啟狀態檔與新增環境變數
What：`README.md` 四處增修。工具表新增 `tools/write-guides.sh` 一列，`tools/deploy.sh` 那一列補上收尾寫重啟狀態檔與 `restart` 行；環境變數表新增 `JSC_HOME` 與 `JSC_RESTART_GATE` 兩列；新增「部署留在機器上的檔案」一節，用表列出三個檔案的產生時機與用途，並寫明兩份指引一律整份覆寫、`uninstall` 兩者都不產生。
Why：部署會在機器上留下三個檔案，這件事原本 README 一個字都沒寫。操作者不知道更新與移除的依據就在 `$JSC_HOME` 底下，也不知道 `restart-required` 存在代表什麼，只能去讀腳本註解。
How：三個檔案併成一張表，欄位是「何時產生」與「用途」，讓人一眼分得出哪些是可以放心刪的（指引重跑就有）、哪些有判定意義（重啟狀態檔）。閘門的判讀與逃生門明寫在 `jsc-hooks` 那一邊，`jsc-cli` 只負責寫狀態檔，避免兩份文件各寫一套判定規則。
Who：讀 `jsc-cli` 說明的操作者，以及要手動更新或移除技能組的人。
|
2026-08-27 16:34:16 +08:00 |
|
|
jiantw83
|
9377c2fbc7
|
feat(config-spec): 設定規格表補上重啟閘門、兩份指引與四項既有設定共九列
What：`tools/config-spec.tsv` 新增九列。這次新增的五項：`JSC_RESTART_GATE`、`JSC_WIKI_REPO_SKILLSET`、`$JSC_HOME/update-guide.md`、`$JSC_HOME/remove-guide.md`、`$JSC_HOME/restart-required`；補登既有但漏列的四項：`JSC_LANG_GUARD`、`JSC_COMMENT_SCOPE`、`JSC_CHANGED_FILE`、`JSC_SIMPLIFIED_FILE`。
Why：這一份是體檢與設定共用的唯一規格表，`scan-config.sh` 與 `/jsc-cli:doctor` 都讀它。沒登錄的設定項體檢查不到，等於機器上有一批設定沒人管；`orphans` 那一側也對不起來。準則寫的「新增設定時要同步補一列」就是為了這件事。
How：兩份指引標 `manual`，缺了就重跑 `/jsc-cli:deploy`，不由體檢自動補。`$JSC_HOME/restart-required` 與 `JSC_CHANGED_FILE`、`JSC_SIMPLIFIED_FILE` 都是執行期暫態，驗證與修法欄一律標 `none` 與 `-`：不存在是正常狀態，標成必要項會讓體檢把「沒有待重啟的部署」誤判成缺失。三個 `off` 開關（`JSC_RESTART_GATE`、`JSC_LANG_GUARD`、`JSC_COMMENT_SCOPE`）預設值一律寫 `on`，說明欄講明什麼情況才關。九列的欄位數與既有列一致為 8 欄。
Who：`scan-config.sh`、`/jsc-cli:doctor` 的執行環境體檢與 `/jsc-cli:setup` 的引導設定。
|
2026-08-27 16:34:16 +08:00 |
|
|
jiantw83
|
eca467696f
|
feat(deploy): deploy 技能收尾加上產生指引與要求重啟兩步
What：`skills/deploy/SKILL.md` 新增兩個步驟並改寫 `description`。新的第 7 步：install 或 update 在所有 CLI 跑完之後，整台機器跑一次 `tools/write-guides.sh {mode} {domain}...`，完成條件是兩份指引都印出 `wrote` 行；原本的回報順延為第 8 步；新的第 9 步：收尾一律印出重啟指示「請關閉目前的工作階段並重新啟動，新的技能內容才會載入」，並把兩份指引的路徑講出來。
Why：兩份指引與重啟提示都是部署收尾的一部分，腳本做得到、技能流程沒寫，就等於沒人會跑。重啟這件事尤其要在收尾講清楚：`deploy.sh` 已經把這一輪記進 `$JSC_HOME/restart-required`，使用者不知道要重啟就會繼續用舊版技能，然後以為部署沒生效。
How：指引那一步明寫「整台機器跑一次」，排在每個 CLI 都跑完之後——第 5 步是一個 CLI 一個子代理，指引寫的卻是整台機器的樣貌，跟著 CLI 跑就會被覆寫成最後一支的內容。`uninstall` 跳過這一步：指引描述的是裝好的技能組。重啟指示用固定字句，不讓每次回報各講一套；`JSC_RESTART_GATE=off` 作為逃生門一併寫出，判讀在 `jsc-hooks`。
Who：`/jsc-cli:deploy` 技能的執行流程與收尾回報。
|
2026-08-27 16:34:16 +08:00 |
|
|
jiantw83
|
c397994ce8
|
feat(deploy): 部署收尾轉呼叫 restart-gate.sh require 掛上重啟閘門
What：`tools/deploy.sh` 新增 `restart_gate_sh()` 與 `mark_restart()` 兩個函式，並在全部指令成功、印出 `result` 之前呼叫 `mark_restart`。`install` 與 `update` 會轉呼叫 `jsc-hooks` 的 `hooks/restart-gate.sh require {模式} {domain}...` 掛上重啟閘門，成功就多印一行 `restart<TAB>{狀態檔路徑}`；`uninstall` 與 dry-run 不寫。輸出行別表與檔頭的環境變數說明同步補上。
Why：部署換掉的是磁碟上的技能檔，目前工作階段載入的還是舊版。這段落差期間跑技能，改動看起來沒生效，人會以為部署失敗又重跑一次。要有一個「這台機器有一輪部署還沒重啟」的證據留在檔案上，判定那一端才擋得下來。
How：狀態檔的路徑、格式與判讀全留在 `jsc-hooks` 的 `restart-gate.sh`，這裡只轉呼叫它的 `require` 子命令，比照 `jsc-sdlc` 轉呼叫 `sdlc-gate.sh wp-lock` 的慣例。兩邊各拼一份格式就會對不上：這裡一開始自己寫四欄 TSV，而 hooks 那端讀的是 `key=value`，狀態檔存在卻解不出欄位，改成轉呼叫才修好，格式只能有一個真實來源。找腳本的順序比照 `jsc-sdlc` 的 `wp-gate.sh`：環境變數 `JSC_HOOKS_DIR` 優先，再找並排的工作樹，最後找 plugin 快取；找不到就印 `note` 行據實說「這次沒有掛上重啟閘門」，不自己補寫一份——閘門本來就由 `jsc-hooks` 判讀，它不在就沒有判定點，寫下去只是留一個沒人讀的檔案，還會讓下一輪誤以為閘門掛上了。`require` 一律接 `</dev/null`：它不讀標準輸入，但這裡的標準輸入是宿主餵進來的管線，不關掉會卡住。
Who：`/jsc-cli:deploy` 的 install 與 update 收尾，與 `jsc-hooks` 的部署後重啟閘門對接。
|
2026-08-27 16:34:16 +08:00 |
|
|
jiantw83
|
d1da14c778
|
feat(write-guides): 新增指引產生腳本，部署收尾寫下本機的更新與移除指引
What：新增 `tools/write-guides.sh`（`write-guides.sh [-n] {install|update} {domain}...`），產生 `$JSC_HOME/update-guide.md` 與 `$JSC_HOME/remove-guide.md` 兩份指引，兩份都整份覆寫。輸出 TSV 四種行別：`cli`（偵測到的 CLI）、`plan`（dry-run 時會寫入的檔案）、`wrote`（實際寫入的檔案）、`note`（非致命說明）；結束碼 0 寫成、2 參數錯誤、4 目錄或檔案寫不進去。
Why：更新與移除這兩件事原本只存在於技能內文裡。CLI 壞掉、沒有工作階段、或是換人接手的時候，機器上找不到任何一份寫著「這台機器要怎麼更新、怎麼移除」的東西，只能回頭讀技能。指引落成本機檔案，不開工作階段也照著走得完。
How：內容一律依實際偵測結果生成，不寫死。CLI 清單來自 `detect-clis.sh`；每支 CLI 的指令字面直接取自 `deploy.sh -n` 的輸出，所以指引寫的就是 `deploy.sh` 真正會跑的指令——各 CLI 的差異只有 `deploy.sh` 一個真實來源，這裡再抄一份就會有兩套指令，改了一邊忘了另一邊，指引就開始騙人。kiro 走不走本地複製退路，也是讀 `deploy.sh` 的 `note` 行判斷，不自己再探測一次。獨立成一支腳本、不併進 `deploy.sh`：`deploy.sh` 的職責是「對單一 CLI 部署」，一輪部署會逐個 CLI 呼叫它，而指引寫的是整台機器的樣貌，只該產生一次；併進去還會與 `deploy.sh -n` 形成雙向遞迴。寫檔走暫存檔再 `mv`，寫一半不會留下半份指引。移除指引另外列出 plugin 指令管不到的殘留物（`$JSC_HOME`、本地 clone、kiro 技能目錄、rc 檔的 `# jsc-config` 段落）與各自清掉的影響。
Who：`/jsc-cli:deploy` 的 install 與 update 收尾，以及日後要手動更新或整組移除的操作者。
|
2026-08-27 16:34:16 +08:00 |
|