monol-plugin-scout 2.1.3 → 4.1.0

package/monol-plugin-scout-pkg/skills/priority.md

@@ -0,0 +1,77 @@
+---
+description: 우선순위 분석 - 플러그인 점수 상세 분석 (한글: 우선순위, 점수, 분석)
+argument-hint: "<plugin-name>"
+allowed-tools: [Read, Bash]
+---
+
+# /scout priority - 우선순위 분석
+
+플러그인의 종합 점수와 상세 분석을 제공합니다.
+
+## 사용법
+
+```
+/scout priority <plugin>     # 플러그인 점수 분석
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/priority-scorer.sh breakdown "$ARGUMENTS"
+```
+
+## 점수 구성
+
+| 요소 | 가중치 | 설명 |
+|------|--------|------|
+| 프로젝트 매칭 | 40% | 현재 프로젝트와의 적합성 |
+| 팀 인기도 | 25% | 팀 내 사용률 및 추천 |
+| 개인 이력 | 20% | 이전 설치/거절 이력 |
+| 신선도 | 15% | 최근 업데이트 여부 |
+
+## 점수 해석
+
+| 점수 | 등급 | 의미 |
+|------|------|------|
+| 80+ | Excellent | 강력 추천 |
+| 60-79 | Good | 추천 |
+| 40-59 | Fair | 검토 권장 |
+| 40 미만 | Poor | 비추천 |
+
+## 출력 형식
+
+```markdown
+## 플러그인 점수 분석: eslint-fix
+
+| 요소 | 점수 | 가중치 |
+|------|------|--------|
+| 프로젝트 매칭 | 85 | 40% |
+| 팀 인기도 | 65 | 25% |
+| 개인 이력 | 50 | 20% |
+| 신선도 | 80 | 15% |
+
+**종합 점수: 72점 (Good)**
+
+### 분석
+- 프로젝트의 eslint 설정과 높은 호환성
+- 팀 내 2명이 사용 중, 1건의 공유 추천
+- 이전 거절 이력 없음
+- 최근 30일 내 업데이트됨
+```
+
+## 예시
+
+```
+/scout priority eslint-fix
+→ eslint-fix 플러그인의 상세 점수 분석
+
+/scout priority typescript-lsp
+→ typescript-lsp 플러그인의 상세 점수 분석
+```
+
+## 관련 명령어
+
+- `/scout` - 플러그인 추천 (점수 기반 정렬)
+- `/scout compare` - 플러그인 비교

package/monol-plugin-scout-pkg/skills/quiet.md

@@ -0,0 +1,73 @@
+---
+description: 무음 모드 - 추천 알림 비활성화 (한글: 무음, 조용히, 알림끄기)
+argument-hint: "[on | off | status]"
+allowed-tools: [Read, Bash]
+---
+
+# /scout quiet - 무음 모드
+
+플러그인 추천 알림을 일시적으로 비활성화합니다.
+
+## 사용법
+
+```
+/scout quiet           # 현재 상태 확인
+/scout quiet on        # 무음 모드 활성화
+/scout quiet off       # 무음 모드 비활성화
+/scout quiet toggle    # 무음 모드 토글
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### 상태 확인 (기본)
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh quiet status
+```
+
+### 무음 모드 활성화
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh quiet on
+```
+
+무음 모드가 활성화되면:
+- Stop Hook에서 자동 추천이 표시되지 않음
+- `/scout` 명령어는 정상 동작
+- 수동으로 해제할 때까지 유지
+
+### 무음 모드 비활성화
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh quiet off
+```
+
+## 출력 형식
+
+```markdown
+## 무음 모드
+
+**상태**: [활성화 | 비활성화]
+
+무음 모드가 활성화되면 자동 추천이 표시되지 않습니다.
+수동으로 `/scout`를 실행하면 추천을 확인할 수 있습니다.
+
+### 설정 변경
+- `/scout quiet on` - 무음 모드 켜기
+- `/scout quiet off` - 무음 모드 끄기
+```
+
+## 예시
+
+```
+/scout quiet
+→ 현재 무음 모드: 비활성화
+
+/scout quiet on
+→ 무음 모드가 활성화되었습니다.
+
+/scout quiet off
+→ 무음 모드가 비활성화되었습니다.
+```

package/monol-plugin-scout-pkg/skills/schedule.md

@@ -0,0 +1,95 @@
+---
+description: 스케줄 관리 - 정기 작업 예약 (한글: 예약, 스케줄, 정기작업)
+argument-hint: "[list | add | remove] ..."
+allowed-tools: [Read, Bash, AskUserQuestion]
+---
+
+# /scout schedule - 스케줄 관리
+
+정기적인 플러그인 관련 작업을 예약합니다.
+
+## 사용법
+
+```
+/scout schedule                          # 예약된 작업 목록
+/scout schedule add <type> <interval>    # 작업 추가
+/scout schedule remove <id>              # 작업 삭제
+/scout schedule run                      # 대기 중인 작업 실행
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### 목록 조회 (기본)
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/scheduler.sh list
+```
+
+### 작업 추가
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/scheduler.sh add <type> <interval> [target] [message]
+```
+
+작업 유형:
+- `check-updates` - 플러그인 업데이트 확인
+- `cleanup` - 캐시 및 로그 정리
+- `audit` - 보안 감사
+- `remind` - 리마인더
+
+주기:
+- `daily` - 매일
+- `weekly` - 매주
+- `monthly` - 매월
+- `once` - 일회성
+
+### 작업 삭제
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/scheduler.sh remove <task-id>
+```
+
+### 대기 중인 작업 실행
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/scheduler.sh run-due
+```
+
+## 출력 형식
+
+```markdown
+## 예약된 작업
+
+| ID | 유형 | 주기 | 대상 | 다음 실행 | 상태 |
+|----|------|------|------|----------|------|
+| abc123 | cleanup | weekly | all | 2026-01-29 | 활성 |
+| def456 | check-updates | daily | all | 2026-01-23 | 활성 |
+
+### 명령어
+- `/scout schedule add cleanup weekly` - 주간 정리 추가
+- `/scout schedule add remind once all "플러그인 검토하기"` - 리마인더 추가
+- `/scout schedule remove abc123` - 작업 삭제
+```
+
+## 예시
+
+```
+/scout schedule
+→ 예약된 작업 목록
+
+/scout schedule add cleanup weekly
+→ 주간 정리 작업 추가
+
+/scout schedule add remind daily all "플러그인 업데이트 확인"
+→ 매일 리마인더 추가
+
+/scout schedule remove abc123
+→ 작업 삭제
+```
+
+## 관련 명령어
+
+- `/scout quiet` - 무음 모드
+- `/scout frequency` - 추천 빈도 설정

package/monol-plugin-scout-pkg/skills/scout.md

@@ -1,7 +1,13 @@
 ---
 description: 플러그인 마켓플레이스 스캔 및 추천
-argument-hint: "[--quick | --category <cat> | compare | cleanup | explore | audit | fork]"
+argument-hint: "[--quick | --category <cat> | console | compare | cleanup | explore | audit | fork]"
 allowed-tools: [Read, Glob, Grep, Bash, WebFetch, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh scout"
+          timeout: 5
 ---
 
 # /scout - 플러그인 마켓플레이스 스캔 및 추천
@@ -19,11 +25,14 @@ allowed-tools: [Read, Glob, Grep, Bash, WebFetch, AskUserQuestion]
 ## 서브커맨드
 
 ```
+/scout console            # 플러그인 대시보드 콘솔 → console.md 참조
 /scout compare <a> <b>    # 플러그인 비교 → compare.md 참조
 /scout cleanup            # 미사용 플러그인 정리 → cleanup.md 참조
 /scout explore [category] # 마켓플레이스 탐색 → explore.md 참조
 /scout audit              # 보안/업데이트 점검 → audit.md 참조
 /scout fork <src> <name>  # 플러그인 포크 → fork.md 참조
+/scout install <plugin>   # 플러그인 설치 → install.md 참조
+/scout uninstall <plugin> # 플러그인 제거 → uninstall.md 참조
 ```
 
 ## 인자: $ARGUMENTS
@@ -32,29 +41,30 @@ allowed-tools: [Read, Glob, Grep, Bash, WebFetch, AskUserQuestion]
 
 ### Phase 1: 프로젝트 컨텍스트 분석
 
-1. **프로젝트 타입 감지**:
-   ```
-   package.json          → Node.js/JavaScript/TypeScript
-   requirements.txt      → Python
-   pyproject.toml        → Python (modern)
-   Cargo.toml            → Rust
-   go.mod                → Go
-   pom.xml / build.gradle → Java
-   composer.json         → PHP
-   Gemfile               → Ruby
+1. **프로젝트 분석기 실행**:
+   ```bash
+   bash ${CLAUDE_PLUGIN_ROOT}/lib/project-analyzer.sh full
    ```
 
-2. **프레임워크 식별** (의존성에서 추출):
-   - React, Vue, Angular, Svelte (frontend)
-   - Express, Fastify, NestJS (Node backend)
-   - FastAPI, Django, Flask (Python)
-   - Spring, Quarkus (Java)
+   결과:
+   - projectTypes: nodejs, typescript, python, etc.
+   - frameworks: react, express, jest, etc.
+   - dependencies: 상위 20개 의존성
+   - suggestedCategories: 추천 카테고리
 
-3. **설치된 플러그인 확인**:
+2. **설치된 플러그인 확인**:
    - `~/.claude/settings.json`의 `enabledPlugins`
    - `.claude/settings.json`의 프로젝트 플러그인
    - 이미 설치된 플러그인은 추천에서 제외
 
+3. **거절 이력 확인**:
+   ```bash
+   bash ${CLAUDE_PLUGIN_ROOT}/lib/rejection-learner.sh stats
+   ```
+   - 3회 이상 거절된 플러그인 제외
+   - 30일 쿨다운 중인 플러그인 제외
+   - 차단된 카테고리의 플러그인 제외
+
 ### Phase 2: 마켓플레이스 스캔
 
 1. **설정된 마켓플레이스 조회**:

package/monol-plugin-scout-pkg/skills/skills.md

@@ -0,0 +1,230 @@
+---
+description: skills.sh 스킬 스카우트 - 스킬 탐색, 추천, 설치 (한글: 스킬찾기, 스킬추천, 스킬설치)
+argument-hint: "[search <query> | recommend | install <id> | list | combos]"
+allowed-tools: [Read, Bash, WebFetch, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh skills"
+          timeout: 5
+---
+
+# /scout skills - skills.sh 스킬 스카우트
+
+## skills.sh란?
+
+[skills.sh](https://skills.sh)는 Claude Code용 커뮤니티 스킬 마켓플레이스입니다.
+스킬(skill)은 Claude Code의 기능을 확장하는 가벼운 모듈로, 플러그인보다 단순하고 빠르게 설치할 수 있습니다.
+
+스킬 스카우트는 skills.sh에서 프로젝트에 적합한 스킬을 발견하고 추천합니다.
+
+## 사용법
+
+```
+/scout skills                     # 상태 표시
+/scout skills search <query>      # 키워드 검색
+/scout skills recommend           # 맞춤 추천
+/scout skills install <id>        # 스킬 설치
+/scout skills list                # 설치 목록
+/scout skills combos              # 시너지 추천
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### Phase 1: 카탈로그 동기화
+
+skills.sh API에서 전체 스킬 카탈로그를 가져옵니다.
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh fetch
+```
+
+**API 동작:**
+- `GET https://skills.sh/api/skills?limit=500&offset=0` 호출
+- `hasMore` 플래그로 페이지네이션 (0.1초 간격)
+- 결과를 `data/.cache/skills-catalog.json`에 캐시
+- 캐시 TTL: config.yaml `skills_sh.cache_ttl` (기본 3600초)
+- 네트워크 실패 시: 캐시가 있으면 캐시 반환, 없으면 빈 배열
+
+### Phase 2: Anthropic 공식 스킬 자동 설치
+
+Anthropic이 공식 제공하는 스킬은 사용자 확인 없이 자동 설치합니다.
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh auto
+```
+
+**판별 기준:**
+- `topSource === "anthropics/skills"` 인 스킬만 대상
+- config.yaml `skills_sh.auto_install_official: true` 일 때만 동작
+- npx 사전 확인 (`check_npx`)
+
+**설치 방법:**
+- `npx skills add <skill-id>` 실행
+- `~/.claude/skills/` 디렉토리에 설치됨
+- 설치 결과를 `data/.last-skill-install.json`에 기록
+- `data/history.json`의 `skills.installed`에 이력 저장
+
+**세션 시작 시 자동 실행:**
+이 기능은 on-session-start 훅에서 호출되어 매 세션마다 새 공식 스킬을 자동으로 설치합니다.
+
+### Phase 3: 추천 (커뮤니티 스킬)
+
+미설치 스킬을 점수 기반으로 평가하여 추천합니다.
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh recommend 5
+```
+
+**점수 산출 방식 (0-100점):**
+
+#### 인기도 (50% 가중치)
+
+스킬의 설치 수(installs/downloads)를 기준으로 정규화합니다.
+
+| 설치 수 | 점수 |
+|---------|------|
+| 1000+ | 100 |
+| 500+ | 80 |
+| 100+ | 60 |
+| 50+ | 40 |
+| 10+ | 20 |
+| 10 미만 | 10 |
+
+#### 프로젝트 매칭 (30% 가중치)
+
+`lib/project-analyzer.sh types`의 결과와 스킬의 이름/태그/설명을 비교합니다.
+매칭 횟수에 비례하여 점수 부여 (최대 100점).
+
+#### 소스 신뢰도 (20% 가중치)
+
+| 소스 | 점수 |
+|------|------|
+| `anthropics/*` | 100 |
+| `verified/*`, `official/*` | 70 |
+| 커뮤니티 (기타) | 40 |
+
+**추천 흐름:**
+1. 카탈로그 fetch (캐시 활용)
+2. 설치된 스킬 제외
+3. 각 스킬 점수 계산
+4. 점수 내림차순 정렬
+5. 상위 N개 반환 (config.yaml `skills_sh.max_recommendations`)
+6. AskUserQuestion (multiSelect)으로 설치 선택
+
+```yaml
+questions:
+  - question: "추천된 스킬 중 설치할 것을 선택하세요:"
+    header: "스킬 추천"
+    options:
+      - label: "<skill-name> (점수: XX/100)"
+        description: "<skill-description>"
+    multiSelect: true
+```
+
+선택된 각 스킬에 대해:
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh install <skill-id>
+```
+
+### Phase 4: 키워드 검색
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh search "<query>"
+```
+
+카탈로그에서 이름, 태그, 설명을 대소문자 무시로 검색합니다.
+매칭된 결과는 점수순으로 정렬됩니다.
+
+### Phase 5: 시너지 콤보 추천
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh combos
+```
+
+설치된 플러그인(`~/.claude/settings.json`의 `enabledPlugins`)을 기반으로
+보완적인 스킬을 추천합니다.
+
+**콤보 매핑:**
+
+| 설치된 플러그인 키워드 | 추천 스킬 키워드 |
+|----------------------|----------------|
+| typescript-lsp | typescript-strict, type-coverage, ts-refactor |
+| code-review | pr-description, review-checklist |
+| commit-commands | conventional-commits, changelog-gen |
+| sentry | error-tracking, alert-config |
+| react | react-patterns, component-gen |
+| testing | test-gen, coverage-report |
+
+카탈로그에서 추천 스킬 키워드와 매칭되는 실제 스킬을 찾아
+`_reason` (시너지 이유)과 함께 반환합니다.
+
+## 상태 확인
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh status
+```
+
+표시 항목:
+- 설치된 스킬 수 + 목록
+- 마지막 동기화 시각 (캐시 파일 mtime)
+- skills_sh 설정 요약 (enabled, auto_install_official, cache_ttl, max_recommendations)
+- 마지막 자동 설치 결과 (`.last-skill-install.json`)
+
+## 안전 규칙
+
+1. **Anthropic 공식만 자동 설치**
+   - `topSource: "anthropics/skills"` 인 스킬만 사용자 확인 없이 설치
+   - 커뮤니티 스킬은 반드시 AskUserQuestion으로 동의 후 설치
+
+2. **npx 사전 확인**
+   - 스킬 설치 전 `command -v npx` 확인
+   - npx 미설치 시 Node.js 설치 방법 안내 메시지 출력
+
+3. **네트워크 안전**
+   - curl --max-time 10 제한
+   - API 실패 시 캐시 폴백
+   - 캐시도 없으면 빈 배열 반환 (에러로 중단하지 않음)
+
+4. **이력 추적**
+   - 모든 설치를 history.json에 기록
+   - 자동 설치 결과를 .last-skill-install.json에 기록
+   - 설치 소스 (auto/manual) 구분
+
+5. **설정 존중**
+   - config.yaml `skills_sh` 섹션의 설정값 우선
+   - `enabled: false`이면 전체 비활성
+   - `auto_install_official: false`이면 자동 설치 비활성
+
+## 예시
+
+```
+/scout skills
+→ 설치된 스킬 현황과 상태 표시
+
+/scout skills search typescript
+→ "typescript" 관련 스킬 검색 (이름/태그/설명 매칭)
+
+/scout skills recommend
+→ 프로젝트 분석 기반 맞춤 추천, multiSelect로 설치
+
+/scout skills install conventional-commits
+→ npx skills add conventional-commits 실행
+
+/scout skills combos
+→ 설치된 플러그인 기반 시너지 스킬 추천
+
+/scout skills list
+→ ~/.claude/skills/ + 플러그인 스킬 목록
+```
+
+## 에러 처리
+
+- **npx 없음**: Node.js 설치 안내 출력
+- **네트워크 실패**: 캐시 폴백 → 빈 결과 반환
+- **빈 카탈로그**: 추천 없이 빈 배열 반환
+- **설치 실패**: 에러 메시지 출력, 다른 스킬 설치는 계속 진행
+- **config.yaml 없음**: 모든 설정 기본값 사용

package/monol-plugin-scout-pkg/skills/team.md

@@ -0,0 +1,117 @@
+---
+description: 팀 협업 - 팀원 통계 및 추천 공유 (한글: 팀, 팀원, 협업)
+argument-hint: "[members | stats | share | shared | summary]"
+allowed-tools: [Read, Bash, AskUserQuestion]
+---
+
+# /scout team - 팀 협업
+
+팀원별 플러그인 사용 통계와 추천 공유 기능입니다.
+
+## 사용법
+
+```
+/scout team                  # 팀 요약
+/scout team members          # 팀원 목록
+/scout team stats            # 팀 통계 갱신
+/scout team share <plugin>   # 플러그인 추천 공유
+/scout team shared           # 공유된 추천 목록
+/scout team name <name>      # 팀 이름 설정
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### 팀 요약 (기본)
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/team-manager.sh summary
+```
+
+팀 전체 현황을 표시합니다:
+- 총 멤버 수, 활성 멤버 수
+- 사용된 플러그인 수
+- 인기 플러그인 TOP 3
+- 공유된 추천
+
+### 팀원 목록
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/team-manager.sh members
+```
+
+### 팀 통계 갱신
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/team-manager.sh stats
+```
+
+7일 내 활성 멤버, 전체 플러그인 사용량 등을 계산합니다.
+
+### 플러그인 추천 공유
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/team-manager.sh share <plugin> "<reason>"
+```
+
+팀원들에게 플러그인을 추천합니다. 추천 사유를 함께 남기면 좋습니다.
+
+### 공유된 추천 목록
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/team-manager.sh shared
+```
+
+## 출력 형식
+
+```markdown
+## 팀 요약: [팀 이름]
+
+### 멤버
+- 총 멤버: 4명
+- 활성 멤버 (7일 내): 3명
+
+### 플러그인 사용
+- 총 사용 플러그인: 12개
+- 인기 플러그인:
+  1. commit-commands (4명 사용)
+  2. code-review (3명 사용)
+  3. typescript-lsp (2명 사용)
+
+### 공유 추천
+| 플러그인 | 추천 사유 | 추천자 |
+|----------|----------|--------|
+| eslint-fix | 코드 품질 향상 | kent |
+| prettier | 포맷 통일 | john |
+
+### 관리
+- `/scout team name <팀명>` - 팀 이름 설정
+- `/scout team share <plugin> "<사유>"` - 추천 공유
+```
+
+## 예시
+
+```
+/scout team
+→ 팀 요약 표시
+
+/scout team share eslint-fix "코드 품질 향상에 필수!"
+→ eslint-fix 플러그인을 팀에 추천
+
+/scout team shared
+→ 공유된 추천 목록
+
+/scout team name "Frontend Team"
+→ 팀 이름을 "Frontend Team"으로 설정
+```
+
+## 자동 등록
+
+세션 시작 시 현재 사용자가 자동으로 팀에 등록됩니다.
+Git 사용자 정보(user.name, user.email)가 함께 저장됩니다.
+
+## 관련 명령어
+
+- `/scout console` - 콘솔에서 팀 통계 확인
+- `/scout` - 개인 추천 (팀 추천과 병합 가능)