jiantw83
d8769ec76a
什麼：為 .agents/plugins/marketplace.json 補上 description、owner 欄位，並為所有 plugin 項目補上各自的 description；同時修正 .claude-plugin/marketplace.json 中 jsc-meta 描述的標點（斜線改為頓號）。 為什麼：兩份 marketplace.json 與 plugins/jsc 的標準格式不同步，缺少的欄位會讓其他 CLI（antigravity 等）讀到的 marketplace metadata 不完整。 如何：對照 plugins/jsc 的 canonical marketplace.json，逐一補齊頂層 description、owner 物件，以及每個 plugin 的 description 欄位；統一標點用字。 誰：jsc-meta:skill-check 例行合規稽核。
jsc-log — 工作日誌與統計
jsc 技能組的 log domain：工作完成後把十項資訊寫入 wiki 日誌頁（LOG_{HASH}，HASH 依共享規則計算；首碼若是數字或 A／B／C，改成 H 加上原前 7 碼；頁內仍按工作週週五整理），統計技能使用次數與呼叫鏈次數，並把技能執行的教訓記到 LEARN_{HASH}，供下次執行前查閱。
安裝、更新、移除
Marketplace 統一為 jsc（https://gitea.jsc.idv.tw/plugins/jsc.git），安裝 token 為 jsc-log@jsc。每個指令一行：
| CLI | 安裝 | 更新 | 移除 |
|---|---|---|---|
| claude | claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/jsc.git && claude plugin install jsc-log@jsc |
claude plugin marketplace update jsc && claude plugin update jsc-log@jsc |
claude plugin uninstall jsc-log@jsc |
| codex | codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/jsc.git && codex plugin add jsc-log@jsc |
codex plugin marketplace upgrade jsc |
codex plugin remove jsc-log@jsc |
| copilot | copilot plugin marketplace add https://gitea.jsc.idv.tw/plugins/jsc.git && copilot plugin install jsc-log@jsc |
copilot plugin marketplace update jsc && copilot plugin update jsc-log@jsc |
copilot plugin uninstall jsc-log@jsc |
| antigravity | git clone https://gitea.jsc.idv.tw/plugins/log.git ~/plugins/log && agy plugin install ~/plugins/log |
git -C ~/plugins/log pull && agy plugin uninstall jsc-log && agy plugin install ~/plugins/log |
agy plugin uninstall jsc-log |
| kiro | kiro-cli plugin marketplace add https://gitea.jsc.idv.tw/plugins/jsc.git && kiro-cli plugin install jsc-log@jsc |
kiro-cli plugin marketplace update jsc && kiro-cli plugin update jsc-log@jsc |
kiro-cli plugin uninstall jsc-log@jsc |
antigravity 不支援 gitea URL 安裝，改用本地 clone 路徑。批次操作五個 CLI：使用
/jsc-cli:deploy。
工具
| 工具 | 用途 |
|---|---|
tools/usage-stats.sh |
聚合 $JSC_HOME/usage/*.jsonl：skills 列技能使用次數、chains 列呼叫鏈次數（皆降冪），--cli <name> 過濾 |
tools/worklog-target.sh |
依 {owner}/{repo} 產生 LOG_{HASH}、LOG_CONTENTS 與符合共享規則的 HASH |
Skills 目錄
呼叫方式：Claude / Antigravity /jsc-log:{name}；Codex ${name}；Copilot / Kiro 描述需求自動觸發。
worklog
工作完成後蒐集十項資訊（存取庫、分支、計畫連結、工作包連結、花費時間、token 用量、任務狀態、執行細節、困難與解決、PR 目標分支），用 tools/worklog-target.sh 產生目標頁，再套範本附加到 LOG_{HASH} 與 LOG_CONTENTS。
stats
統計本技能組各技能的使用次數與呼叫鏈使用次數，資料來源為 jsc-hooks 記錄的 skills.jsonl 與 chains.jsonl。
learn
技能執行後把教訓（日期、技能、CLI、情境、教訓、下次做法）附加到 LEARN_{HASH} 並更新 LEARN_CONTENTS；技能執行前查閱同兩頁，套用相符的「下次做法」。
範本
| 檔案 | 用途 |
|---|---|
templates/log-entry.md |
單筆工作日誌（十欄位） |
templates/log-contents.md |
日誌目錄 LOG_CONTENTS |
templates/learn-page.md |
教訓紀錄頁 LEARN_{HASH}（六欄表格，逐列附加） |
templates/learn-contents.md |
教訓目錄 LEARN_CONTENTS |
環境變數
Wiki 位置：日誌頁用 JSC_WIKI_REPO_LOG、教訓頁用 JSC_WIKI_REPO_LEARN，未設定退回 JSC_WIKI_REPO，再未設定就詢問（見 jsc-gitea）。先讀目前 shell 繼承的環境變數，缺值才詢問。