fix/deploy-domain-prefix-and-kiro-plugin-probe #15

2026-08-26T03:30:45Z

jiantw83 commented

2026-08-26 03:30:45 +00:00

摘要

需求描述：上一輪部署三支新技能時實際踩到的兩個問題，這次一併修掉。一是 domain 名的前綴歧義導致四支 CLI 更新全部失敗，二是 kiro-cli 缺 plugin 子指令時每次都先洗一堆誤導性錯誤訊息。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`tools/deploy.sh`	domain 參數正規化：收到帶 `jsc-` 前綴的名字自動去掉，避免兜成雙重前綴。新增 `kiro_has_plugin_cmd` 一次性探測，這個版本的 kiro-cli 不認得 `plugin` 子指令就整批直接走複製退路
`skills/deploy/SKILL.md`	第 4 步補上一句：`plugins[].name` 已帶前綴，傳給 `deploy.sh` 不必事先剝掉
三份 manifest	版本 0.1.3

設計重點

正規化放在腳本層，不是只改文件。文件只能提醒讀文件的人，腳本自己防呆才管得到所有呼叫端，不管是技能步驟、sub agent 手動下指令，還是以後別的工具呼叫它。
kiro 的探測不算部署動作，不印 cmd／exit。混進逐指令的輸出裡，會讓人以為那也是一次失敗的部署嘗試。
探測用 kiro-cli --help-all 抓子指令清單裡有沒有 plugin 這一行，一次性判斷後整批走同一條路，不是每個 domain 各撞一次錯誤才退回。

測試結果

sh -n tools/deploy.sh：通過。
混傳前綴測試：jsc-ask jsc-cli git 三種格式混傳給 claude、codex（install 模式）、kiro，全部正確組成 jsc-ask@jsc、jsc-cli@jsc、jsc-git@jsc，沒有雙重前綴。
kiro 探測：這台機器裝的 kiro-cli 2.18.1 確認沒有 plugin 子指令，update kiro ask cli 實際執行（非 dry-run）乾淨完成，只印一行 note 說明改走複製，沒有再出現 unrecognized subcommand 的錯誤輸出，result 為 ok。
jsc-meta/tools/ste100-lint.sh：無違規。

前置 Push Request

無

## 摘要 - 需求描述：上一輪部署三支新技能時實際踩到的兩個問題，這次一併修掉。一是 domain 名的前綴歧義導致四支 CLI 更新全部失敗，二是 kiro-cli 缺 `plugin` 子指令時每次都先洗一堆誤導性錯誤訊息。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `tools/deploy.sh` | domain 參數正規化：收到帶 `jsc-` 前綴的名字自動去掉，避免兜成雙重前綴。新增 `kiro_has_plugin_cmd` 一次性探測，這個版本的 kiro-cli 不認得 `plugin` 子指令就整批直接走複製退路 | | `skills/deploy/SKILL.md` | 第 4 步補上一句：`plugins[].name` 已帶前綴，傳給 `deploy.sh` 不必事先剝掉 | | 三份 manifest | 版本 0.1.3 | ## 設計重點 - **正規化放在腳本層，不是只改文件**。文件只能提醒讀文件的人，腳本自己防呆才管得到所有呼叫端，不管是技能步驟、sub agent 手動下指令，還是以後別的工具呼叫它。 - **kiro 的探測不算部署動作**，不印 `cmd`／`exit`。混進逐指令的輸出裡，會讓人以為那也是一次失敗的部署嘗試。 - 探測用 `kiro-cli --help-all` 抓子指令清單裡有沒有 `plugin` 這一行，一次性判斷後整批走同一條路，不是每個 domain 各撞一次錯誤才退回。 ## 測試結果 - `sh -n tools/deploy.sh`：通過。 - 混傳前綴測試：`jsc-ask jsc-cli git` 三種格式混傳給 claude、codex（install 模式）、kiro，全部正確組成 `jsc-ask@jsc`、`jsc-cli@jsc`、`jsc-git@jsc`，沒有雙重前綴。 - kiro 探測：這台機器裝的 `kiro-cli 2.18.1` 確認沒有 `plugin` 子指令，`update kiro ask cli` 實際執行（非 dry-run）乾淨完成，只印一行 `note` 說明改走複製，沒有再出現 `unrecognized subcommand` 的錯誤輸出，`result` 為 `ok`。 - `jsc-meta/tools/ste100-lint.sh`：無違規。 ## 前置 Push Request - 無

jiantw83 added 1 commit 2026-08-26 03:30:45 +00:00

fix(deploy): 修正 domain 前綴歧義與 kiro-cli 探測 49cd4d3ee4

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 的執行正確性與輸出可讀性。

admin approved these changes 2026-08-26 03:31:57 +00:00

admin merged commit 27ddf4e5a6 into develop

2026-08-26 03:32:00 +00:00

admin deleted branch fix/deploy-domain-prefix-and-kiro-plugin-probe

2026-08-26 03:32:00 +00:00

jiantw83 referenced this pull request

2026-08-26 03:32:32 +00:00

release: develop 併入 master（deploy 修正） #16

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/cli#15