---
name: stats
description: Report usage counts of every jsc skill and every skill call chain, aggregated by tools/usage-stats.sh from $JSC_HOME/usage/*.jsonl recorded by jsc-hooks. Supports --cli filtering. Use when the user asks how often skills or chains are used; not for token or time stats (see worklog).
---

# stats — 技能與呼叫鏈使用統計

資料由 `jsc-hooks/hooks/skill-usage.sh` 持續記錄在 `$JSC_HOME/usage/`（預設 `~/.jsc/usage/`）。

## 操作

| 統計 | 指令 | 輸出 |
| --- | --- | --- |
| 各技能使用次數 | `tools/usage-stats.sh skills` | `次數<TAB>技能名`，降冪 |
| 各呼叫鏈使用次數 | `tools/usage-stats.sh chains` | `次數<TAB>from -> to`，降冪 |
| 依 CLI 過濾 | 加 `--cli claude`（或 codex / copilot / antigravity / kiro） | 同上 |

## 呈現

1. 直接執行工具，把輸出整理成表格回覆。
2. 沒有資料時說明：需先安裝 `jsc-hooks` 並執行 `jsc-hooks:hooks-install` 接線。