skill-metricslisted

# skill-metrics Claude Code가 남긴 세션 JSONL(`~/.claude/projects/**/*.jsonl`)을 집계해 스킬/워크플로우 사용을 **정량 지표**로 환산한다. 목적은 두 가지다: 1. **자동화 우선순위 산정** — 무엇을 먼저 스킬·체인·훅으로 자동화하면 임팩트가 큰가. 2. **상시 측정** — 도달률·빈도 추이로 스킬 채택/이탈을 추적한다. > 측정은 전부 번들된 `scripts/measure.py`가 수행한다. Claude가 JSONL을 직접 > 읽어 토큰을 태우지 않는다 — 스크립트를 호출하고 결과 마크다운만 해석한다. --- ## 실행 절차 ### Step 1: 측정 스크립트 실행 스킬 디렉토리의 `scripts/measure.py`를 실행한다. 인자(`$ARGUMENTS`)로 기간을 받는다. ```bash # 기본: 최근 14일, stdout 출력 python3 "$SKILL_DIR/scripts/measure.py" --days 14 # 특정 시작일부터 python3 "$SKILL_DIR/scripts/measure.py" --since 2026-06-05 --until 2026-06-19 # 프로젝트 필터 + 파일 저장 python3 "$SKILL_DIR/scripts/measure.py" --days 14 --project myproject --out /tmp/skill-metrics.md ``` 주요 옵션: | 옵션 | 의미 | 기본 | |---|---|---| | `--days N` | 오늘 기준 최근 N일 | 14 | | `--since YYYY-MM-DD` | 시작일 (지정 시 `--days` 무시) | — | | `--until YYYY-MM-DD` | 종료일 | 오늘 | | `--project <부분문자열>` | 프로젝트 경로 필터 (예: `myproject`) | 전체 | | `--top N` | 랭킹 표 상위 N개 | 15 | | `--out <경로>` | 마크다운 저장 (미지정 시 stdout) | — | `$ARGUMENTS`가 숫자면 `--days`로, `YYYY-MM-DD` 형식이면 `--since`로 넘긴다. ### Step 2: 결과 해석 스크립트 출력을 그대로 사용자에게 보여주되, **상위 3개 자동화 후보**와 **묶음 후보(transition)** 를 짚어 "다음에 무엇을 자동화하면 좋은지" 한두 줄로 요약한다. ### Step 3 (선택): 회고에 연결 주간 회고(`retrospective`) 맥락이면, 이 지표를 자동화 우선순위의 정량 근거로 인용한다. 결과를 보존하려면 회사 문서의 `<프로젝트>/reports/`(예: `~/workspace/<프로젝트>/docs/engineering/reports/`) 또는 `~/workspace/<회사문서>/retrospective/`에 저장을 제안한다 (사용자 확인 후). --- ## 지표 정의 ### ① AutoScore — 자동화 우선순위 ``` AutoScore = 주간