# jsc-log — 工作日誌與統計

jsc 技能組的 log domain：工作完成後把十項資訊寫入 wiki 日誌頁（`LOG_{yyyyMM}_W{週數}`，週數基於週五日期計算），並統計技能使用次數與呼叫鏈次數。

## 安裝

```bash
claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/log.git
claude plugin install jsc-log@log
```

其他 CLI（codex / copilot / antigravity / kiro）與批次安裝、更新、解除安裝：使用 `/jsc-cli:deploy`。

## 工具

| 工具 | 用途 |
| --- | --- |
| `tools/usage-stats.sh` | 聚合 `$JSC_HOME/usage/*.jsonl`：`skills` 列技能使用次數、`chains` 列呼叫鏈次數（皆降冪），`--cli <name>` 過濾 |

## Skills 目錄

呼叫方式：Claude / Antigravity `/jsc-log:{name}`；Codex `${name}`；Copilot / Kiro 描述需求自動觸發。

<!-- JSC-SKILLS:START -->

### `worklog`

工作完成後蒐集十項資訊（存取庫、分支、計畫連結、工作包連結、花費時間、token 用量、任務狀態、執行細節、困難與解決、PR 目標分支），套範本附加到 `LOG_{yyyyMM}_W{週數}` 與 `LOG_CONTENTS`。

### `stats`

統計本技能組各技能的使用次數與呼叫鏈使用次數，資料來源為 jsc-hooks 記錄的 `skills.jsonl` 與 `chains.jsonl`。

<!-- JSC-SKILLS:END -->

## 範本

| 檔案 | 用途 |
| --- | --- |
| `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 讀寫