jiantw83andClaude Fable 5 fac3285ca7 feat(learn): 新增技能教訓紀錄與查閱技能及 LEARN wiki 頁範本
What:新增 skills/learn/SKILL.md(record/consult 兩種模式)與 templates/learn-page.md、templates/learn-contents.md 兩份 wiki 頁範本。
Why:參考 oh-my-pi 的 learn 工具,讓技能執行後能把教訓沉澱下來、執行前能先查閱套用,避免同樣的問題重複發生。
How:教訓以六欄表格(日期、技能、CLI、情境、教訓、下次做法)逐列附加到 LEARN_{HASH},並同步更新 LEARN_CONTENTS 目錄;HASH 依共用 8 碼 wiki hash 規則(含 H 前綴退回),wiki 位置依 JSC_WIKI_REPO_LEARN → JSC_WIKI_REPO 解析,讀寫皆透過 jsc-gitea:wiki。
Who:jsc-log domain 的 learn 技能(教訓紀錄與查閱功能)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-24 11:36:45 +08:00
2026-08-21 04:43:45 +00:00

jsc-log — 工作日誌與統計

jsc 技能組的 log domain:工作完成後把十項資訊寫入 wiki 日誌頁(LOG_{HASH},HASH 依共享規則計算;首碼若是數字或 A/B/C,改成 H 加上原前 7 碼;頁內仍按工作週週五整理),並統計技能使用次數與呼叫鏈次數。

安裝、更新、移除

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。

範本

檔案 用途
templates/log-entry.md 單筆工作日誌(十欄位)
templates/log-contents.md 日誌目錄 LOG_CONTENTS

環境變數

Wiki 位置:JSC_WIKI_REPO_LOG,未設定退回 JSC_WIKI_REPO,再未設定就詢問(見 jsc-gitea)。

相關 domain

  • jsc-hooks:花費時間(session-timer.sh report)與用量資料來源
  • jsc-gitea:wiki 讀寫
S
Description
No description provided
Readme
380 KiB
Languages
Shell 100%