monol-plugin-scout 2.1.3 → 4.1.0

package/monol-plugin-scout-pkg/commands/frequency.md

@@ -0,0 +1,32 @@
+---
+description: 추천 빈도 설정 (한글: 빈도, 횟수, 추천빈도)
+argument-hint: "[session | daily | cooldown] <value>"
+allowed-tools: [Read, Bash]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh frequency"
+          timeout: 5
+---
+
+# /scout frequency - 추천 빈도 설정
+
+skills/frequency.md를 참조하여 동작합니다.
+
+## 인자: $ARGUMENTS
+
+## 동작 요약
+
+1. 현재 빈도 설정 조회
+2. session/daily/cooldown 값 변경
+3. history.json preferences 업데이트
+
+## 예시
+
+```
+/scout frequency              # 현재 설정 확인
+/scout frequency session 2    # 세션당 2회
+/scout frequency daily 5      # 하루 5회
+/scout frequency cooldown 60  # 1시간 간격
+```

package/monol-plugin-scout-pkg/commands/install.md

@@ -0,0 +1,32 @@
+---
+description: 플러그인 설치 (한글: 설치, 플러그인설치)
+argument-hint: "<plugin-name[@marketplace]>"
+allowed-tools: [Read, Bash, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh install"
+          timeout: 5
+---
+
+# /scout install - 플러그인 설치
+
+skills/install.md를 참조하여 동작합니다.
+
+## 인자: $ARGUMENTS
+
+## 동작 요약
+
+1. 플러그인 존재 및 거절 이력 확인
+2. AskUserQuestion으로 설치 확인
+3. 승인 시 `lib/plugin-manager.sh install` 실행
+4. 거절 시 `lib/rejection-learner.sh record` 실행
+
+## 예시
+
+```
+/scout install typescript-lsp
+/scout install code-review@monol
+/scout install --list
+```

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

@@ -0,0 +1,30 @@
+---
+description: 우선순위 분석 (한글: 우선순위, 점수)
+argument-hint: "<plugin-name>"
+allowed-tools: [Read, Bash]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh priority"
+          timeout: 5
+---
+
+# /scout priority - 우선순위 분석
+
+skills/priority.md를 참조하여 동작합니다.
+
+## 인자: $ARGUMENTS
+
+## 동작 요약
+
+1. 플러그인 점수 계산
+2. 요소별 상세 분석
+3. 종합 점수 및 등급 표시
+
+## 예시
+
+```
+/scout priority eslint-fix
+/scout priority typescript-lsp
+```

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

@@ -0,0 +1,32 @@
+---
+description: 무음 모드 - 추천 알림 비활성화 (한글: 무음, 조용히, 알림끄기)
+argument-hint: "[on | off | status]"
+allowed-tools: [Read, Bash]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh quiet"
+          timeout: 5
+---
+
+# /scout quiet - 무음 모드
+
+skills/quiet.md를 참조하여 동작합니다.
+
+## 인자: $ARGUMENTS
+
+## 동작 요약
+
+1. 현재 무음 모드 상태 확인
+2. on/off/toggle로 모드 변경
+3. 변경 사항 history.json에 저장
+
+## 예시
+
+```
+/scout quiet           # 상태 확인
+/scout quiet on        # 무음 모드 활성화
+/scout quiet off       # 무음 모드 비활성화
+/scout quiet toggle    # 토글
+```

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

@@ -0,0 +1,32 @@
+---
+description: 스케줄 관리 (한글: 예약, 스케줄, 정기작업)
+argument-hint: "[list | add | remove | run]"
+allowed-tools: [Read, Bash, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh schedule"
+          timeout: 5
+---
+
+# /scout schedule - 스케줄 관리
+
+skills/schedule.md를 참조하여 동작합니다.
+
+## 인자: $ARGUMENTS
+
+## 동작 요약
+
+1. 예약된 작업 목록 조회
+2. 작업 추가/삭제
+3. 대기 중인 작업 실행
+
+## 예시
+
+```
+/scout schedule                          # 목록
+/scout schedule add cleanup weekly       # 주간 정리 추가
+/scout schedule remove abc123            # 삭제
+/scout schedule run                      # 대기 작업 실행
+```

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

@@ -19,11 +19,14 @@ allowed-tools: [Read, Glob, Grep, Bash, WebFetch, AskUserQuestion]
 ## 서브커맨드
 
 ```
-/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 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 trusted-install [on|off|status|check|run]  # 신뢰된 자동 설치 → trusted-install.md 참조
+/scout trust [@author|remove|list|export]         # 신뢰 작성자 관리 → trust.md 참조
+/scout skills [search|recommend|install|list|combos] # skills.sh 스킬 탐색 → skills.md 참조
 ```
 
 ## 인자: $ARGUMENTS

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

@@ -0,0 +1,160 @@
+---
+description: skills.sh 스킬 탐색 및 설치 (한글: 스킬, 스킬찾기, 스킬스카우트)
+argument-hint: "[search <query> | recommend | install <id> | list | combos]"
+allowed-tools: [Read, Bash, WebFetch, AskUserQuestion]
+---
+
+# /scout skills - skills.sh 스킬 탐색 및 설치
+
+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
+```
+
+- 캐시 TTL 내이면 로컬 캐시 사용 (기본 1시간)
+- 네트워크 실패 시 캐시 폴백, 캐시 없으면 빈 배열 반환
+
+### Phase 2: Anthropic 공식 스킬 자동 설치
+
+`topSource: "anthropics/skills"` 인 스킬은 사용자 확인 없이 자동 설치합니다.
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh auto
+```
+
+- config.yaml `skills_sh.auto_install_official: true` 일 때만 동작
+- 이미 설치된 스킬은 건너뜀
+- 설치 결과를 `.last-skill-install.json`에 기록
+
+### Phase 3: 커뮤니티 스킬 추천
+
+미설치 커뮤니티 스킬을 점수로 평가하여 추천합니다.
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh recommend 5
+```
+
+**점수 계산 (0-100)**:
+
+| 가중치 | 요소 | 설명 |
+|--------|------|------|
+| 50% | 인기도 (installs) | 설치 수 기반 정규화 |
+| 30% | 프로젝트 매칭 | 이름/태그 vs 프로젝트 언어/프레임워크 |
+| 20% | 소스 신뢰도 | anthropics/* = 100, verified = 70, community = 40 |
+
+AskUserQuestion으로 multiSelect 제시:
+
+```yaml
+questions:
+  - question: "추천된 스킬 중 설치할 것을 선택하세요:"
+    header: "스킬 추천"
+    options:
+      - label: "<skill-name> (점수: XX)"
+        description: "<description>"
+      # ... 추천된 스킬 목록
+    multiSelect: true
+```
+
+선택된 스킬에 대해 `lib/skill-scout.sh install <id>` 실행.
+
+### Phase 4: 시너지 콤보 추천
+
+설치된 플러그인 기반으로 보완 스킬을 추천합니다.
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh combos
+```
+
+콤보 매핑:
+
+| 설치된 플러그인 | 추천 스킬 |
+|----------------|----------|
+| 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 |
+
+## 서브커맨드 상세
+
+### search <query>
+
+키워드로 스킬을 검색합니다. 이름, 태그, 설명에서 대소문자 무시 매칭.
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh search "$query"
+```
+
+결과를 점수순으로 정렬하여 표시.
+
+### recommend
+
+프로젝트 컨텍스트를 분석하여 맞춤 추천. `lib/project-analyzer.sh types`로 프로젝트 타입 감지.
+
+### install <id>
+
+특정 스킬을 `npx skills add <id>`로 설치.
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh install "$id"
+```
+
+### list
+
+설치된 스킬 목록과 상태를 표시.
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/skill-scout.sh status
+```
+
+### combos
+
+설치된 플러그인 기반 시너지 스킬 추천.
+
+## 예시
+
+```
+/scout skills
+→ 설치된 스킬 현황 + 상태 표시
+
+/scout skills search typescript
+→ "typescript" 키워드로 스킬 검색
+
+/scout skills recommend
+→ 프로젝트 분석 후 맞춤 스킬 추천 (multiSelect)
+
+/scout skills install conventional-commits
+→ conventional-commits 스킬 설치
+
+/scout skills combos
+→ 설치된 플러그인 기반 시너지 추천
+```
+
+## 안전 규칙
+
+1. **Anthropic 공식만 자동 설치** - `topSource: "anthropics/skills"` 스킬만 무확인 설치
+2. **커뮤니티 스킬은 확인 필요** - AskUserQuestion으로 사용자 동의 후 설치
+3. **npx 사전 확인** - npx 미설치 시 설치 방법 안내
+4. **네트워크 실패 안전** - 캐시 폴백, 빈 결과 반환 (에러로 중단하지 않음)
+5. **설치 이력 기록** - history.json에 모든 설치 이력 저장

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

@@ -0,0 +1,32 @@
+---
+description: 팀 협업 - 팀원 통계 및 추천 공유 (한글: 팀, 팀원, 협업)
+argument-hint: "[members | stats | share | shared | summary]"
+allowed-tools: [Read, Bash, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh team"
+          timeout: 5
+---
+
+# /scout team - 팀 협업
+
+skills/team.md를 참조하여 동작합니다.
+
+## 인자: $ARGUMENTS
+
+## 동작 요약
+
+1. 팀 데이터 초기화 (없으면)
+2. 요청된 하위 명령어 실행
+3. 결과 포맷팅하여 출력
+
+## 예시
+
+```
+/scout team                  # 팀 요약
+/scout team members          # 팀원 목록
+/scout team share eslint     # 추천 공유
+/scout team shared           # 공유 추천 목록
+```

package/monol-plugin-scout-pkg/commands/timing.md

@@ -0,0 +1,32 @@
+---
+description: 스마트 타이밍 설정 (한글: 타이밍, 추천시점)
+argument-hint: "[after-commit | after-pr | always] [on | off]"
+allowed-tools: [Read, Bash]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh timing"
+          timeout: 5
+---
+
+# /scout timing - 스마트 타이밍 설정
+
+skills/timing.md를 참조하여 동작합니다.
+
+## 인자: $ARGUMENTS
+
+## 동작 요약
+
+1. 현재 타이밍 설정 조회
+2. after-commit/after-pr 설정 변경
+3. history.json smartTiming 업데이트
+
+## 예시
+
+```
+/scout timing                 # 현재 설정 확인
+/scout timing after-commit on # 커밋 후에만 추천
+/scout timing after-pr on     # PR 후에만 추천
+/scout timing always          # 항상 추천
+```

package/monol-plugin-scout-pkg/commands/trust.md

@@ -0,0 +1,85 @@
+---
+description: 신뢰 작성자 관리 (한글: 신뢰, 트러스트)
+argument-hint: "[@author | remove @author | list | export]"
+allowed-tools: [Read, Bash, AskUserQuestion]
+---
+
+# /scout trust — 신뢰 작성자 관리
+
+신뢰 작성자(trusted authors) 목록을 관리합니다. 신뢰 목록에 포함된 작성자의 플러그인은 자동 설치 시 추가 확인 없이 승인됩니다.
+
+## 사용법
+
+```
+/scout trust @author          # 신뢰 작성자 추가
+/scout trust add @author      # 신뢰 작성자 추가 (명시적)
+/scout trust remove @author   # 신뢰 작성자 제거
+/scout trust list             # 신뢰 목록 조회
+/scout trust export           # 감사 로그 내보내기
+```
+
+## 인자: $ARGUMENTS
+
+| 인자 | 설명 |
+|------|------|
+| `@author` 또는 `add @author` | 해당 작성자를 신뢰 목록에 추가 |
+| `remove @author` | 해당 작성자를 신뢰 목록에서 제거 |
+| `list` | 현재 신뢰 작성자 전체 목록 표시 |
+| `export` | 신뢰 관련 감사 로그를 JSON으로 내보내기 |
+
+## 동작
+
+### Phase 1: 인자 파싱
+
+- `$ARGUMENTS`가 비어 있으면 `list` 서브커맨드로 처리
+- `@`로 시작하거나 `add`로 시작하면 추가 흐름
+- `remove`로 시작하면 제거 흐름
+- `list`, `export`는 해당 서브커맨드 실행
+
+### Phase 2: 추가 (add)
+
+1. `config.yaml`의 `auto_install.trusted_authors` 배열 확인
+2. 이미 존재하면 안내 후 종료
+3. **AskUserQuestion**으로 사용자에게 확인:
+   > "@{author}"을(를) 신뢰 작성자로 추가하시겠습니까? 이 작성자의 플러그인은 자동 설치 시 추가 확인 없이 승인됩니다.
+4. 승인 시 `lib/trust-manager.sh add <author>` 실행
+5. 결과 출력
+
+### Phase 3: 제거 (remove)
+
+1. "Anthropic"은 보호된 작성자로 제거 불가 → 오류 메시지
+2. 존재하지 않으면 안내 후 종료
+3. `lib/trust-manager.sh remove <author>` 실행
+4. 결과 출력
+
+### Phase 4: 목록 (list)
+
+1. `lib/trust-manager.sh list` 실행
+2. 결과를 정리하여 출력
+
+### Phase 5: 감사 내보내기 (export)
+
+1. `lib/trust-manager.sh export` 실행
+2. 내보내기 파일 경로를 사용자에게 안내
+
+## 예시
+
+```
+# 작성자 추가
+/scout trust @vercel
+→ "@vercel"을(를) 신뢰 작성자로 추가하시겠습니까? [확인 후 추가]
+
+# 작성자 제거
+/scout trust remove @vercel
+→ Removed "vercel" from trusted authors.
+
+# 목록 조회
+/scout trust list
+→ === Trusted Authors ===
+     1. Anthropic
+     2. vercel
+
+# 감사 로그 내보내기
+/scout trust export
+→ Audit exported to: data/trust-audit-export.json
+```

package/monol-plugin-scout-pkg/commands/trusted-install.md

@@ -0,0 +1,98 @@
+---
+description: 신뢰된 플러그인 자동 설치 관리 (한글: 자동설치, 신뢰설치)
+argument-hint: "[on | off | status | check | run]"
+allowed-tools: [Read, Bash, AskUserQuestion]
+---
+
+# /scout trusted-install - 신뢰된 자동 설치
+
+skills/trusted-install.md를 참조하여 동작합니다.
+
+## 인자: $ARGUMENTS
+
+## 동작 요약
+
+### `on` — Opt-in (활성화)
+
+1. AskUserQuestion으로 사용자 확인:
+   ```yaml
+   questions:
+     - question: "신뢰된 저자(Anthropic 등)의 공식 플러그인을 자동 설치하시겠습니까?"
+       header: "Trusted Auto-Install 활성화"
+       options:
+         - label: "활성화"
+           description: "세션 시작 시 새 공식 플러그인을 자동 설치합니다"
+         - label: "취소"
+           description: "변경하지 않습니다"
+       multiSelect: false
+   ```
+2. 사용자가 "활성화"를 선택하면:
+   ```bash
+   bash ${CLAUDE_PLUGIN_ROOT}/lib/trusted-installer.sh enable
+   ```
+3. 활성화 결과를 안내
+
+### `off` — Opt-out (비활성화)
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/trusted-installer.sh disable
+```
+
+### `status` — 현재 설정 및 마지막 실행 결과
+
+1. config.yaml의 auto_install 설정 표시
+2. history.json의 preferences.trustedAutoInstall 상태 표시
+3. .last-auto-install.json의 마지막 실행 결과 표시:
+   ```bash
+   bash ${CLAUDE_PLUGIN_ROOT}/lib/trusted-installer.sh status
+   ```
+
+### `check` — 드라이런 (설치 없이 확인)
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/trusted-installer.sh check
+```
+
+출력:
+- 현재 활성/비활성 상태
+- 신뢰된 저자 목록
+- 설치 후보 플러그인 (설치되지 않은 것만)
+- 신규 출시된 플러그인 (이전 캐시 대비)
+- 현재 설치된 플러그인 수
+
+### `run` — 즉시 실행 (수동)
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/trusted-installer.sh run
+```
+
+활성화 상태에서만 동작. 비활성화 상태면 안내 메시지 출력.
+
+## 예시
+
+```
+/scout trusted-install on
+→ AskUserQuestion으로 확인 후 활성화
+
+/scout trusted-install off
+→ 즉시 비활성화
+
+/scout trusted-install status
+→ 설정 상태 + 마지막 실행 결과
+
+/scout trusted-install check
+→ 설치 후보 목록 표시 (변경 없음)
+
+/scout trusted-install run
+→ 누락된 공식 플러그인 설치 실행
+```
+
+## 안전 규칙
+
+1. **명시적 opt-in 필수** — `on` 시 반드시 사용자 확인 (AskUserQuestion)
+2. **이중 확인** — config.yaml + history.json 둘 다 true여야 동작
+3. **신뢰된 저자만** — config.yaml `trusted_authors`에 등록된 저자만 대상
+4. **LSP 필터링** — LSP 플러그인은 프로젝트 언어 매칭 시에만 설치
+5. **충돌 감지** — 동일 기능 플러그인 중복 설치 방지
+6. **오프라인 폴백** — 마켓플레이스 접근 불가 시 캐시 사용, 실패 시 조용히 종료
+7. **settings.json 백업** — 설치 전 자동 백업 (plugin-manager.sh)

package/monol-plugin-scout-pkg/commands/uninstall.md

@@ -0,0 +1,31 @@
+---
+description: 플러그인 제거 (한글: 제거, 삭제, 언인스톨)
+argument-hint: "<plugin-name>"
+allowed-tools: [Read, Bash, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh uninstall"
+          timeout: 5
+---
+
+# /scout uninstall - 플러그인 제거
+
+skills/uninstall.md를 참조하여 동작합니다.
+
+## 인자: $ARGUMENTS
+
+## 동작 요약
+
+1. 설치 여부 및 사용량 확인
+2. AskUserQuestion으로 제거 확인
+3. 승인 시 `lib/plugin-manager.sh uninstall` 실행
+4. 비활성화만 선택 시 `lib/plugin-manager.sh disable` 실행
+
+## 예시
+
+```
+/scout uninstall old-formatter
+/scout remove unused-plugin
+```

package/monol-plugin-scout-pkg/config.yaml

@@ -58,6 +58,19 @@ cleanup:
   # 자동 정리 (false = 수동 확인)
   auto_remove: false
 
+# 거절 학습 설정
+rejection_learning:
+  # 활성화
+  enabled: true
+  # 재추천 쿨다운 (일)
+  cooldown_days: 30
+  # 영구 차단 임계값 (회)
+  block_threshold: 3
+  # 카테고리 차단 임계값 (회)
+  category_block_threshold: 5
+  # 거절 이유 추적
+  track_reasons: true
+
 # 캐시 설정
 cache:
   enabled: true
@@ -74,3 +87,47 @@ notifications:
   security_updates: true
   # 업데이트 가능 알림
   available_updates: true
+
+# ============================================================================
+# 서버 동기화 설정 (monol-server)
+# ============================================================================
+# 동기화 활성화 (false로 비활성화)
+sync_enabled: true
+
+# monol-server URL
+sync_server_url: "http://localhost:3030"
+
+# 팀 ID (선택사항, 팀 대시보드용)
+sync_team: ""
+
+# 요청 타임아웃 (초)
+sync_timeout: 5
+
+# ============================================================================
+# 신뢰된 자동 설치 (Trusted Auto-Install)
+# ============================================================================
+auto_install:
+  enabled: false                # /scout trusted-install on 으로 opt-in
+  trusted_authors: ["Anthropic"]
+  marketplace: "claude-plugins-official"
+  lsp_language_filter: true     # LSP는 프로젝트 언어 매칭 필요
+  scope: "user"
+  # 오프라인 폴백
+  cache_catalog: true           # marketplace 카탈로그 로컬 캐시
+  cache_ttl: 86400              # 24시간
+  # 신규 출시 감지
+  detect_new_releases: true     # 이전 vs 현재 비교
+  # 충돌 감지
+  check_conflicts: true         # 동일 기능 플러그인 감지
+
+# ============================================================================
+# skills.sh 통합
+# ============================================================================
+skills_sh:
+  enabled: true
+  api_base: "https://skills.sh/api"
+  auto_install_official: true   # topSource: anthropics/* 자동 설치
+  cache_ttl: 3600               # 1시간 캐시
+  max_recommendations: 5
+  # 시너지 추천
+  combo_suggestions: true       # 플러그인 기반 보완 스킬 추천