plugins/cli
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
141 Commits 10 Branches 0 Tags
2d5d966adc48318f792c212ce25c0351c9973d1f
Commit Graph
18 Commits
Author SHA1 Message Date
jiantw83 a439636c4a feat(deploy): 部署收尾刷新 current 連結農場 
$JSC_HOME/current 是一組不帶版本的符號連結，每個外掛一條，指向快取裡帶版本號的實體目錄。技能文件裡所有跨外掛的腳本呼叫都以這一層為根，因為它不帶版本號、寫得進權限允許清單。

問題是沒有任何東西會更新這些連結，只有 wire-cli.sh 會更新 jsc-hooks 那一條。其餘幾條是人手動建的，建好之後就停在當時的版本。實際後果是部署完四個 domain 之後，快取裡是新版，連結卻還指著舊版：助理巡檢照文件的字面路徑跑，跑到的是舊腳本，而其中一個舊版底下根本沒有它要呼叫的檔案。失敗無聲，只有心跳停止，沒人盯就不會有人發現。

部署改成收尾時刷新整組連結。挑部署來做，是因為它本來就知道裝了哪些 domain、裝到哪個版本，資訊最齊。

四個設計決定：

基準 CLI 取 claude、codex、copilot、kiro 之中第一支找得到的，整輪只有那一支寫連結。連結農場只有一組，不可能同時指向五個 CLI 的副本；而五支 CLI 是平行跑的，五支都寫會互相覆寫，最後指到哪一份是隨機的、出事重現不出來。antigravity 一律不當基準，它的來源是本地 clone，而那份 clone 明文允許是維護者的開發樹，把全機器路徑指到做到一半的樹正好是這次要修的那種毛病。

版本目錄取版本排序最大、且真的有 plugin.json、且本身不是符號連結的那一層。要求 plugin.json 是因為裝到一半的目錄沒有它，挑到會讓連結指向不完整的外掛而且照樣不報錯。

解除安裝的判準是「連結還在、指向卻沒了」，不是「這輪解除安裝過這個 domain」。只解除安裝其中一支 CLI 時，連結可能還指著另一支手上完好的副本，那一條必須留著。

連結建立失敗印一行繼續，不記進失敗清單。這一段跑在外掛都裝好之後，部署本身已經成功；記成失敗會連帶跳過重啟閘門，操作者拿到的是一台明明裝好卻被說成失敗的機器。缺陷仍然看得見，因為輸出多了一行。

目標存在但不是符號連結時一律不覆寫，印 skip 要人工處理。ln -sfn 對著實體目錄下手會把連結建進那個目錄裡，農場當場壞掉還不會報錯。

新增 link 行讓呼叫端讀得到每一條連結指到哪裡，狀態五選一。技能文件與行為契約跟著更新，另修正一句因這次改動而失效的敘述：原本寫 current 底下沒有 jsc-cli，刷新之後那條連結會存在，改成講清楚它仍然靠不住，因為第一次建起它的正是這一輪。
 2026-09-03 12:19:59 +08:00
jiantw83 b41ceb00d9 fix(deploy): 腳本呼叫改成字面絕對路徑，開頭先解一次根目錄 
技能文件新增路徑守則一節，寫明這支技能的每一次腳本呼叫都要是字面絕對路徑，不留未展開的變數，也不留波浪號。

新增 Step 0：開頭跑一次 readlink -f "$JSC_HOME/current" 解出根目錄，整輪只解這一次，之後每一處都把代稱換成那個目錄。解出來的路徑要用 [ -d ] 查過存在才算數——JSC_HOME 沒設時那道指令會印出 /current、結束碼 0，非空又是絕對路徑，只看前三項會直接放行，而那個目錄並不存在。文件同時明講解到 current 這一層就停，不要再往下解一層，因為再解就落到帶版本號的快取路徑，而那種路徑放不進允許清單。

四處跨外掛呼叫改成字面路徑寫法。其中三處原本寫成相對路徑，那才是模型自己補成帶變數路徑的源頭。技能自己的四支腳本另外處理：jsc-cli 不在 current 底下，那裡只有另外三個外掛，所以改用 CLI 載入技能時講明的外掛基底目錄，原樣照抄、不跑指令。

無人看管的輪次在第一支腳本就被權限層擋下，整輪一個外掛都沒部署。2026-09-02 到 09-03 用非互動模式比照排程環境實測多種寫法：權限層拿未展開的字面字串做靜態比對，帶變數或波浪號的路徑對不上任何允許規則，只有允許清單上的完整字面指令跑得動，連 readlink、ls 這種讀取指令都要各自有規則。放寬允許清單解不掉，因為規則本身也是靜態比對，而且路徑中段的萬用字元不匹配。

deploy 是人在現場跑的技能，開頭那一次核准詢問有人可以按，所以保留自己解路徑的做法。守則另外寫下一句擋回頭路：為了看起來整齊而把字面路徑改回帶變數的寫法，等於再一次弄壞每一個無人看管的輪次。

行為說明表的 deploy 四列同步改寫，觸發時機沒動。

影響排程觸發的無人看管輪次，它們現在才跑得完第一支腳本。現場執行部署的操作者只多出開頭那一次核准詢問。
 2026-09-03 10:33:30 +08:00
jiantw83 03e59c69bd feat(狀態回報): 收尾寫一筆 skill-end 事件 
現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。

start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。

status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。
 2026-09-02 16:01:14 +08:00
jiantw83 5f1c4cc6d7 docs(deploy): 同步相依檢查改為照樣更新的行為 
What：SKILL.md 第 4 步改寫成四種結束碼的處置，第 7 步的回報清單補上 warn 行。README 的 check-requires.sh 表格列與 deploy 技能段落改寫成同一套說法。

Why：文件還寫著版本不符就跳過該 domain。操作者依文件預期那個 domain 不會動，實際上它已經更新，回報也對不上腳本印出來的行。

How：SKILL.md 逐一寫出 0、1、4、2 或其他四種結束碼各自的處置與理由，完成條件改成 skip 要有檢查腳本出錯或本地樹的原因、warn 要指名還缺哪一版。README 兩處改寫成同樣的四種分流，並寫明真正的阻擋在 version-guard.sh。

Who：相依版本不符的處置。
 2026-08-31 13:35:42 +08:00
jiantw83 e30bbf5780 feat(cli): 待修項目合併收成共用腳本，檢查改為併行 
「待修項目」表原本由 doctor 與 setup 各寫一次。同一套合併與排序規則寫在
兩個地方，遲早各自漂移：一邊改了排序，另一邊漏掉一整類項目，而且沒有
任何地方看得出來。現在規則只留一份，兩支技能都呼叫它。輸入與輸出都是
TSV，一項都沒有時照樣印一列，呼叫端永遠有東西可以呈現。

doctor 的四項檢查彼此不共用資料，排成一列跑只是把等待時間乘上四倍，
現在同時啟動。doctor 呼叫接線腳本一律帶唯讀旗標，把「打錯一個子命令就
改到或刪掉檔案」的風險移進程式層，不再只靠指令打對。

deploy 的 CLI 偵測、版本結論與 marketplace 清單同樣互不相干，改成併行
取得。版本結論改讀版本守門腳本的單行結論，不再自己從表格推導。setup 把
已經確認過的模式與版本報告直接交給 deploy，操作者不必再答一次同樣的問題。

deploy、doctor、models 都補上結束碼分流：腳本回什麼碼就走哪條路，不再從
輸出內容猜。體檢目錄頁改成先讀回再更新自己那一列，整頁覆蓋會把別台機器
的紀錄一次抹掉。設定規格表補上技能盤點頁要用的環境變數，盤點頁才有地方
可寫。
 2026-08-31 11:09:59 +08:00
jiantw83 5e4c413dec fix(codex-deploy): 保留 CLI 自身快取相容路徑 2026-08-28 18:31:04 +08:00
jiantw83 90b89047e3 fix(codex-deploy): 保留舊 hooks 快取相容路徑 2026-08-28 18:18:28 +08:00
jiantw83 4aa691a9cb feat(deploy): update 前檢查 jsc requires 相依版本 2026-08-28 11:59:16 +08:00
jiantw83 d918ccc6dc fix(deploy): 優先從穩定路徑尋找重啟閘門 2026-08-28 11:22:08 +08:00
jiantw83 284292ffcb docs(deploy): 部署說明同步一支 CLI 一份的重啟狀態檔 
What：`README.md`「部署留在機器上的檔案」那張表，`$JSC_HOME/restart-required` 那一列改成 `$JSC_HOME/restart-required.d/{cli}`，寫明一支 CLI 一份、內容是四行 key=value，以及路徑與格式的唯一來源在 `jsc-hooks/hooks/restart-gate.sh`。`skills/deploy/SKILL.md` 第 9 步的路徑說明同步改寫，補上「每支 CLI 只讀自己那一份」與「重啟一支只清自己那份、別支的閘門還立著」，全篇維持英文。

Why：這兩份說的是同一件事在不同讀者面前的樣貌——README 給看存取庫的人，技能文件給執行部署的模型。收尾提示裡的路徑是操作者唯一會拿到的線索，寫成舊的單一檔案就對不上機器上的實況，也會讓人以為重啟一支就把全部閘門解除了，那正是這一輪要修掉的錯誤認知。

How：只改說明，第 9 步的完成判準與那句固定的重啟指示都不動。舊表格那一列原本寫「一行一次成功部署」，其實是四行 key=value 的狀態檔，這次一併訂正。路徑與格式指回 `restart-gate.sh`，兩個存取庫不各自維護一份格式說明。

Who：`jsc-cli` 的存取庫說明與 `jsc-cli:deploy` 技能文件，對齊 `jsc-hooks` 的重啟狀態檔設計。
 2026-08-27 18:49:58 +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 49cd4d3ee4 fix(deploy): 修正 domain 前綴歧義與 kiro-cli 探測 
What: deploy.sh 收到帶 jsc- 前綴的 domain 名時自動去掉前綴再組 jsc-{domain}@jsc；deploy_kiro 先探測這個版本的 kiro-cli 認不認得 plugin 子指令，不認得就整批直接走本地複製退路。
Why: marketplace.json 的 plugins[].name 本身就帶 jsc- 前綴，SKILL.md 只寫「domain 名單來自 marketplace」沒講清楚要不要去前綴，實際執行時餵進去兜成 jsc-jsc-ask@jsc 雙重前綴，claude、copilot、antigravity、kiro 四支 CLI 的更新全部第一輪失敗。另外 kiro-cli 2.18.1 這個版本已經完全沒有 plugin 子指令，逐一嘗試再退回複製會先洗出一長串看似失敗、實則設計內的錯誤訊息。
How: 腳本層正規化 domain 參數（去前綴），比只改文件更可靠——不管呼叫端傳哪種格式都對。kiro 的探測用 kiro-cli --help-all 抓子指令清單，一次性判斷，不逐一撞錯誤才退回；探測本身不算部署動作，不印 cmd／exit。SKILL.md 同步補上前綴說明。
Who: jsc-cli:deploy 的執行正確性與輸出可讀性。
 2026-08-26 11:30:18 +08:00
jiantw83andClaude Opus 5 26ffaa8a07 fix(cli): 補齊稽核缺失並修掉護欄失效 
What：依 jsc-meta:skill-check 的稽核結果修正技能與工具——補上每個步驟的可檢核完成條件、
把留在內文的標準輸入輸出流程下放 tools/、修正查表與退碼路由造成的誤判。

Why：稽核發現這些缺失會讓技能在實際執行時走錯分支或靜默通過。
完成條件缺漏是最常被違反的一項；退碼誤判與查表錯誤則會讓良性狀況被當成失敗。

How：逐項對照 references/guidelines.md 的審核檢查清單修正，新增的工具都有
documented exit codes，並以真實執行驗證每條路徑。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 d5b36d0f6f feat(deploy): 先比對版本，任一 plugin 落後就把更新設為推薦選項 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 13:03:17 +08:00
jiantw83andClaude Opus 5 8adff2535f refactor(marketplace 正本): deploy 的 domain 清單改讀 plugins/meta 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
jiantw83andClaude Fable 5 b8bb868cb8 docs(cli): translate SKILL.md into English per guidelines 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:29:45 +08:00
jiantw83andClaude Fable 5 4dccea8cf6 feat(cli): deploy 改用統一 marketplace jsc（token jsc-{domain}@jsc） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:33 +08:00
jiantw83andClaude Fable 5 8c00934867 feat(cli): 匯入 jsc-cli 技能組 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00