# 계획서: 스킬 사용 추적 시스템 & 대시보드 연동

## 목표
87개+ 스킬의 사용 현황을 실시간으로 파악할 수 있는 추적 시스템 구축 + 대시보드 연동

## 아키텍처

### 1. 스킬 레지스트리 (skill-registry.json)
- `/home/jay/workspace/skills/` 스캔하여 전체 스킬 목록 + 메타데이터 생성
- 카테고리, 상태(active/deprecated), 설명 포함
- 서버 시작 시 자동 갱신

### 2. 스킬 사용 로거 (skill-usage.jsonl)
- JSONL append-only 파일
- 레코드 스키마: `{"skill_id", "timestamp", "team_id", "task_id", "session_type", "duration_ms"}`
- POST /api/skill-log 엔드포인트로 기록

### 3. 대시보드 API 엔드포인트
- GET /api/skills → 전체 스킬 목록 (레지스트리 기반)
- GET /api/skill-usage?period=1d|7d|30d|90d → 사용 통계
- GET /api/skill-usage/active → 현재 활성 스킬 (task-timers 연동)
- POST /api/skill-log → 사용 이벤트 기록

### 4. 프론트엔드 (SkillView.js)
- App.js 탭 추가: { id: 'skill', label: '스킬뷰', shortLabel: '스킬' }
- 3개 섹션: 스킬 목록 + 사용 통계 + 활성 스킬

## 구현 순서
1. skill-registry.json 생성 스크립트 (백엔드)
2. skill-usage.jsonl 로깅 모듈 (백엔드)
3. server.py API 엔드포인트 추가 (백엔드)
4. SkillView.js 프론트엔드 컴포넌트 (프론트엔드)
5. App.js 탭 연동 (프론트엔드)
6. 테스트

## 파일 목록
- 생성: `dashboard/data/skill-registry.json`
- 생성: `dashboard/data/skill-usage.jsonl`
- 생성: `dashboard/components/SkillView.js`
- 생성: `teams/dev1/tests/test_skill_tracker.py`
- 수정: `dashboard/server.py` (API 엔드포인트 추가)
- 수정: `dashboard/components/App.js` (탭 추가)
- 수정: `dashboard/index.html` (SkillView.js 로드)