jiantw83
814f28a6b8
What： - 兩份 marketplace 檔各加一個 jsc-assist 條目，來源網址指向 assist 存取庫。 Why： - 準則要求每個 domain 存取庫都帶同一份 marketplace 檔，任何一個存取庫都能當註冊入口。少了這個條目，各 CLI 的安裝指令找不到 jsc-assist，sync-domains 也不會把它同步下來。 How： - 條目由 meta 的 sync-marketplace.sh 產生，同時寫進正本與每個 domain 存取庫的副本，寫完逐檔比對位元組。這一支存取庫的兩份副本就是那一輪的產物。 - 條目依名稱排序，縮排與非 ASCII 描述的處理都交給同一支腳本，不手改 JSON。 Who： 助理 domain 落地的註冊步驟，其餘 domain 存取庫的同一份副本另外送出。
jsc-assist — 技能助理
jsc 技能組的 assist domain：技能與 hook 每跑一次就留下事件，助理負責把事件收攏、判斷健康狀態、寫進 wiki 的監控頁（MONITOR_{HASH}）。
助理只做三件事：觸發既有技能、巡檢既有的唯讀腳本與狀態檔、把結果提醒給前景會話。它不做決策、不改程式碼、不覆寫 wiki。完整界線見 AGENTS.md 的「助理的界線」。
安裝、更新、移除
Marketplace 統一為 jsc（https://gitea.jsc.idv.tw/plugins/meta.git），安裝 token 為 jsc-assist@jsc。每個指令一行：
| CLI | 安裝 | 更新 | 移除 |
|---|---|---|---|
| claude | claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && claude plugin install jsc-assist@jsc |
claude plugin marketplace update jsc && claude plugin update jsc-assist@jsc |
claude plugin uninstall jsc-assist@jsc |
| codex | codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && codex plugin add jsc-assist@jsc |
codex plugin marketplace upgrade jsc |
codex plugin remove jsc-assist@jsc |
| copilot | copilot plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && copilot plugin install jsc-assist@jsc |
copilot plugin marketplace update jsc && copilot plugin update jsc-assist@jsc |
copilot plugin uninstall jsc-assist@jsc |
| antigravity | git clone https://gitea.jsc.idv.tw/plugins/assist.git ~/plugins/assist && agy plugin install ~/plugins/assist |
git -C ~/plugins/assist pull && agy plugin uninstall jsc-assist && agy plugin install ~/plugins/assist |
agy plugin uninstall jsc-assist |
| kiro | kiro-cli plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && kiro-cli plugin install jsc-assist@jsc |
kiro-cli plugin marketplace update jsc && kiro-cli plugin update jsc-assist@jsc |
kiro-cli plugin uninstall jsc-assist@jsc |
antigravity 不支援 gitea URL 安裝，改用本地 clone 路徑。批次操作五個 CLI：使用
/jsc-cli:deploy。
Skills 目錄
呼叫方式：Claude / Antigravity /jsc-assist:{name}；Codex ${name}；Copilot / Kiro 描述需求自動觸發。
status
查助理現在的狀況，全程唯讀。讀心跳檔判斷助理是不是還在跑——檔案在、而且 ts 距現在不到 300 秒才算新鮮，過期就是沒在跑；接著列出待辦簿裡的每一筆，印成一張現況表。心跳檔不存在時印「助理未運行」，不當成錯誤。這支不寫檔、不寫 wiki、不碰閘門。
相依
| Plugin | 最低版本 | 用途 |
|---|---|---|
jsc-cli |
>=0.2.7 |
CLI 偵測與委派 |
jsc-gitea |
>=0.2.0 |
監控頁的所有 wiki 讀寫，一律經 tools/gitea.sh |
jsc-hooks |
>=0.3.4 |
心跳、閘門與事件來源（$JSC_HOME 底下的狀態檔） |
jsc-log |
>=0.1.4 |
使用統計與工作日誌的資料來源 |
參考與工具
| 檔案 | 用途 |
|---|---|
references/behaviors.md |
本 domain 的技能行為清單：一支技能一節，五列記下觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象，供稽核與驗證比對。格式合約見 plugins/meta 的 references/guidelines.md「技能行為清單」 |
助理的狀態檔
全部放在 $JSC_HOME/assistant/ 底下，一律純文字 key=value：
| 路徑 | 內容 |
|---|---|
heartbeat |
心跳檔，欄位 ts、pid、cli、session。判準只看 ts，不看 pid 存活——五支 CLI 與容器裡的行程互相看不到彼此的 pid |
tasks/{id} |
待辦簿，一筆一檔。一筆一檔是為了讓並行寫入不互相覆寫 |