plugins/cli
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
50 Commits 10 Branches 0 Tags
63d4185a4079a211340fed7420741d558bfff768
Commit Graph
36 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
jiantw83 63d4185a40 fix(deploy): codex 更新補上逐網域 plugin add 
What：deploy_codex 的 update 分支在 marketplace upgrade 之後，補上逐網域的
plugin add，與 install 分支一致。

Why：codex 沒有 plugin update 子指令，只有 add、list、marketplace、remove。
marketplace upgrade 只重抓 marketplace 快照，而 jsc 的 marketplace.json 只列各
網域的 git URL、不含版本，內容不會變，codex 一律回「already up to date」並結束碼 0。
已安裝外掛的版本在 plugin add 當下決定，快取不會被連帶重抓。結果是十個網域裡八個
版本完全沒動，指令卻全部成功——只看結束碼會判定成功，是最難察覺的那種失敗。
實機驗證過：更新前 review 是 0.0.2，跑完 marketplace upgrade 仍是 0.0.2。

How：update 分支照 install 的寫法逐網域跑 plugin add。實測 codex 的 add 會就地
升級到快照裡的最新版（review 0.0.2 升到 0.0.5），不需要先 remove。同時在函式上方
寫明這個限制與理由，避免後人再把那一行當成多餘的重複而刪掉。

Who：跨 CLI 技能組批次部署。
 2026-08-27 10:28:10 +08:00
jiantw83 497a16b877 feat(model-tags): 補上三款舊世代模型的能力標籤 
What：在 `references/model-tags.md` 的對照表新增三列——claude-opus-4.5、claude-sonnet-4.5、gpt-5.4-mini，並把三份 plugin manifest 版本由 0.1.4 升到 0.1.5。

Why：這三款模型仍在線上，實務上常被指定使用。對照表沒有它們，`tools/model-tags.sh` 查不到標籤，jsc-sdlc 的階段閘門就無從判定，規劃與分析階段會被誤擋。

How：依既有欄位格式各補一列標籤。claude-opus-4.5 同時列出 reasoning-max 與 reasoning-high，遵守上位標籤必須並列的規則；claude-sonnet-4.5 給 reasoning-high、coding、long-context、vision，不列 fast；gpt-5.4-mini 比照 gpt-5.x-mini 給 coding、fast、cheap。接著用 jsc-meta 的 sync-skill-manifest.sh 同步 README 技能目錄並升版，README 沒有增減技能小節。

Who：jsc-cli 的 models 技能與其 `tools/model-tags.sh`；下游是 jsc-hooks 的 sdlc-gate，它讀 `$JSC_HOME/model-tags.tsv` 執行閘門。
 2026-08-26 18:40:11 +08:00
jiantw83 a2f1f65ff8 chore(cli): 因應 scan-config.sh 修正，將外掛版本升級至 0.1.4 2026-08-26 12:26:52 +08:00
jiantw83 7077d65766 fix(cli): 展開 $JSC_HOME 時補上文件記載的預設值 ~/.jsc，避免 $JSC_HOME/* 設定列在未設環境變數時被誤判為缺失或未設定 2026-08-26 12:26:52 +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
jiantw83 e655f9a963 feat(setup): 新增引導與自動設定技能 
What: 新增 jsc-cli:setup，讀 doctor 的待修清單逐項確認後修復，並新增 tools/apply-config.sh 負責實際寫入。
Why: 體檢找得出問題，修還是得靠人一個一個查文件。修法又分三種：算得出來的、要人給值的、只能手動的，混在一起講不清楚。
How: 依規格表的 fix 欄分流，auto 直接寫、ask 先用決策樹問到值、manual 印步驟。複合修復交回原主（deploy、hooks-install、models）。apply-config.sh 只動 rc 檔的 # jsc-config 標記段落，寫前備份到 $JSC_HOME/backup/config/，寫後重讀驗證，fish 自動改用 set -gx 語法。
Who: 體檢與修復流程，接在 jsc-cli:doctor 之後。
 2026-08-26 10:43:50 +08:00
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
jiantw83 17329a94d3 feat(cli): 新增 delegate 子代理技能 2026-08-25 16:56:22 +08:00
jiantw83andClaude Opus 5 3082e5167f chore(cli): 三份 manifest 同步升版並同步 marketplace 正本 
What：三份 plugin manifest 版本同步 bump，兩份 marketplace 檔與 plugins/meta 正本對齊。

Why：準則要求技能異動必須同步升版；marketplace 副本必須與正本完全一致。

How：以 jsc-meta 的 tools/sync-skill-manifest.sh 升版，marketplace 檔由正本複製。

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 a739ae20f8 docs(cli): 同步文件與參考資料 
What：更新 README、AGENTS.md、templates 與 references，讓文件敘述與實際行為一致。

Why：稽核發現多處文件與程式行為分歧，違反「每個意義只有單一真實來源」。

How：以實際程式行為為準改寫敘述，重複的規則收成單一來源並以一行指引指過去。

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 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 00cfac58b0 chore(plugin 版本): 三份 manifest 升版至 0.0.6 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 13:03:17 +08:00
jiantw83andClaude Opus 5 de1b9ad8a8 docs(README): 同步 deploy 的版本比對與推薦邏輯 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 13:03:17 +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 abf65226b6 chore(plugin 版本): 三份 manifest 升版至 0.0.5 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +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 Opus 5 30bb201c71 chore(plugin 版本): 三份 manifest 升版至 0.0.4 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 16:05:06 +08:00
jiantw83andClaude Opus 5 c30dd61984 docs(README): 補上 model-tags.sh 與能力標籤閘門的說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 16:05:06 +08:00
jiantw83andClaude Opus 5 519f1163db feat(模型標籤閘門): 新增 model-tags.sh 與 reasoning-max 分級，SDLC 階段閘門改由能力標籤判定 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 16:05:06 +08:00
jiantw83 f2029d4cd0 feat(cli): 新增 model-config.sh 的 resolve 子指令 
What:
在 `tools/model-config.sh` 新增 `resolve {stage}` 子指令。這個指令會取出某個 SDLC 階段的模型鏈（跟 `get {stage}` 用同樣的解析規則：先讀專案的 `.jsc/models`，找不到再讀 `$JSC_HOME/models.conf`），然後印出鏈中第一個模型名稱，當作目前這個 CLI 可用的模型。同時新增 `current_cli()` 這個輔助函式，透過各家 CLI 的環境變數，判斷目前是在 claude、codex、copilot、antigravity、還是 kiro 底下執行。這個版本先把 `current_cli()` 的結果記錄下來，還沒有拿它去過濾模型鏈中不可用的模型，這件事留到之後再做，因為要判斷某個模型是否可用，需要 LLM 層級的判斷，不是單純的 shell script 能做到的。之後的計畫是拿 `current_cli()` 的結果，對照 `references/model-tags.md` 和 `detect-clis.sh`，跳過模型鏈裡不可用的模型。另外，把 README.md 裡 `tools/model-config.sh` 的工具說明表格，加上新的 `resolve {stage}` 子指令說明。版本號也從 0.0.2 升到 0.0.3，同步改了 `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 這三份清單檔，這是這個 repo 的慣例：新增功能時要一併升版號。

Why:
jsc-meta:skill-check 這次稽核發現，jsc-sdlc 底下 plan、analyze、implement、maintain 這四個階段的技能，各自都要幫自己的階段挑一個模型，來做 gate check。如果沒有 `resolve` 這個子指令，這四個技能就要各自在技能說明裡，重複寫一次「讀模型鏈、選一個候補模型」的邏輯。這樣容易寫錯，也難維護。

How:
在既有的 `get`/`list` 邏輯基礎上，加一個 `resolve` 子指令，直接回傳模型鏈的第一個模型。同時加上 `current_cli()`，先把偵測 CLI 的能力做出來，但先不接上過濾邏輯，用註解說明後續要怎麼接。文件和版本號一併更新。

Who:
這個功能是給 jsc-sdlc 的四個階段技能（plan、analyze、implement、maintain）用的。它們可以直接呼叫 `resolve {stage}`，取得一個可用的模型名稱，不用各自重複寫模型鏈的判斷邏輯。
 2026-08-24 14:49:28 +08:00
jiantw83 286b2f7af2 fix(marketplace): 同步兩份 marketplace.json 的說明與擁有者欄位 
What:
`.agents/plugins/marketplace.json` 和 `.claude-plugin/marketplace.json` 兩份檔案內容不一致。這次把兩份都對齊 plugins/jsc 的標準版本。在 `.agents/plugins/marketplace.json` 加上最上層的 description 和 owner（name: "JSC"）欄位，並幫十個外掛（jsc-ask、jsc-cli、jsc-git、jsc-gitea、jsc-hooks、jsc-log、jsc-meta、jsc-pkg、jsc-review、jsc-sdlc）各自補上說明文字。在 `.claude-plugin/marketplace.json` 加上最上層的 description 和 owner 欄位，並修正 jsc-meta 說明文字，把「新建/更新/刪除」改成「新建、更新、刪除」。

Why:
這兩份檔案是 marketplace 的清單檔，內容原本不一致。`.claude-plugin/marketplace.json` 已有每個外掛的說明，但缺最上層欄位。`.agents/plugins/marketplace.json` 完全沒有說明文字。清單檔不一致，會讓不同工具讀到不同資訊，造成混淆，所以要修正。

How:
對照 plugins/jsc 這份標準版本，逐一比對兩份檔案，補齊缺少的欄位，並統一用字。

Who:
這次改動跟 jsc-cli 自己的技能邏輯無關，是整個 repo 層級的一致性修正。目的是讓 jsc-cli 這個 repo 可以正確扮演 marketplace 註冊入口的角色，跟其他 repo 的清單檔保持同步。
 2026-08-24 14:49:16 +08:00
jiantw83andClaude Fable 5 cb6df171f6 chore(manifest): 版本號提升至 0.0.2 
What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份 manifest 的 version 由 0.0.1 提升為 0.0.2。
Why：本次新增角色式模型路由功能（model-config.sh 與相關文件），屬功能性變更，需要新版本號讓各 CLI 的插件更新機制辨識。
How：同步修改三份 manifest 的 version 欄位，維持三處版本一致。
Who：jsc-cli 插件的安裝與更新流程（jsc-cli:deploy 及各 CLI 原生插件命令）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-24 11:36:57 +08:00
jiantw83andClaude Fable 5 072e01821b docs(models): 補上角色式模型路由文件與階段指定模型輸出表 
What：references/model-tags.md 新增「階段指定模型（角色式路由）」章節，說明設定格式、檔案優先序與遞補鏈語意；skills/models/SKILL.md 的 description 與步驟加入 model-config.sh list 的「階段指定模型」輸出表（stage、指定鏈、source 三欄）；README.md 補上 tools/model-config.sh 工具列與 models 技能說明。
Why：角色式模型路由需要文件明確定義設定格式與判定順序，jsc-sdlc 閘門與使用者才知道指定模型優先、標籤比對為備援。
How：設定格式 stage=model[,fallback...]；優先序為專案 .jsc/models 覆寫 $JSC_HOME/models.conf；解析一律透過 jsc-cli/tools/model-config.sh，不自行讀檔；models 技能輸出表未設定的階段以「-」表示。
Who：models 技能的使用者與依賴模型閘門的 jsc-sdlc 各階段技能。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-24 11:36:45 +08:00
jiantw83andClaude Fable 5 de504ee2ed feat(model-config): 新增 SDLC 階段指定模型鏈解析工具 
What：新增 tools/model-config.sh，提供 get {stage} 與 list 兩個子命令，解析 SDLC 各階段（plan、analyze、implement、maintain）的指定模型鏈。
Why：讓 jsc-sdlc 各階段閘門能以角色式模型路由指定模型與遞補鏈，而不是只靠能力標籤比對；同時讓專案能覆寫全域設定。
How：以 POSIX sh 加 awk 實作；先讀專案目錄 .jsc/models，該階段沒設定才退回 $JSC_HOME/models.conf（JSC_HOME 預設 ~/.jsc）；設定格式 stage=model[,fallback...]，同階段多行取最後一行；get 未設定時空輸出且 exit 0，list 每階段輸出 stage、chain、source（未設定印「-」）。
Who：jsc-cli models 技能與 jsc-sdlc 各階段的模型閘門。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-24 11:36:31 +08:00
jiantw83andClaude Fable 5 b72c51c234 chore(cli): 加入統一 jsc marketplace 副本（與正本一致，任一 repo 可作註冊入口） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:37:44 +08:00
jiantw83andClaude Fable 5 fa95753afa style(cli): 中文並列改頓號 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:29:45 +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 8ebe0049bd style(cli): 依 STE100 擬人台灣感規則改寫語感 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:15:55 +08:00
jiantw83andClaude Fable 5 ac7f6e8a30 docs(cli): AGENTS 語言規則改指向 jsc-meta 的 references/ste100.md 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:13:27 +08:00
jiantw83andClaude Fable 5 0e51ce8d1a docs(cli): README 安裝/更新/移除改為每指令一行（五個 CLI）並為相關 domain 加上 repo 連結 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:33 +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 0f28babaaf chore(cli): 版本號改為 0.0.1 並移除個別 marketplace（統一為 jsc） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:33 +08:00
jiantw83andClaude Fable 5 3f03cb14e1 docs(cli): 以統一格式改寫繁體中文 README 與 AGENTS 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +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
jiantw83andClaude Fable 5 03a47f2684 chore(cli): 修正範本 manifest 與移除 hello 範例符合 cli 領域 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:18 +08:00
jiantw83 2c2efb72ae Initial commit 2026-08-21 04:42:50 +00:00