algokit-mcp 1.0.1 → 1.0.2

package/README.md

@@ -72,19 +72,157 @@ cp skills/* ~/.claude/skills/
 
 ### 사용 예시
 
+#### `algo:search` - 문제 검색
+
+```
+You: "골드 난이도 DP 문제 추천해줘"
+
+Claude: "백준에서 골드 티어의 DP 문제를 검색했습니다.
+
+**추천 문제 3개:**
+1. 🥇 [G5] 12865번 - 평범한 배낭 (✅ 16,234명)
+2. 🥇 [G4] 9251번 - LCS (✅ 13,892명)
+3. 🥇 [G3] 1932번 - 정수 삼각형 (✅ 18,234명)
+
+어떤 문제부터 시작하시겠어요?"
 ```
-You: "백준 골드 난이도 DP 문제 3개 추천해줘"
-Claude: [자동으로 BOJ search_problems 호출]
 
-You: "이 문제 분석해줘: https://www.acmicpc.net/problem/1927"
-Claude: [URL 파싱 → analyze_problem_boj 자동 호출]
+```
+You: "https://www.acmicpc.net/problem/1927"
+
+Claude: "백준 1927번 '최소 힙' 문제를 조회했습니다.
+
+**문제 정보:**
+- 난이도: 🥈 Silver I
+- 분류: 자료구조, 우선순위 큐
+- 해결: 28,456명 | 정답률: 47.2%
+
+본문을 보시겠어요? (/algo:fetch)"
+```
+
+#### `algo:hint` - 단계별 힌트
+
+```
+You: "1927번 힌트 줘"
+
+Claude: "**💡 Level 1 힌트 (접근 방향)**
+
+이 문제는 **우선순위 큐(Priority Queue)** 자료구조를 사용합니다.
+Python의 `heapq` 모듈 또는 C++의 `priority_queue`를 활용하면
+O(log N) 시간에 최솟값을 찾을 수 있어요.
+
+더 구체적인 힌트가 필요하신가요?"
+```
+
+```
+You: "더 구체적으로 알려줘"
+
+Claude: "**💡 Level 2 힌트 (구현 방법)**
+
+1. **최소 힙** 사용 (Python: heapq, C++: priority_queue<int, greater<int>>)
+2. x가 0이 아니면 → `heappush(x)`
+3. x가 0이면 → `heappop()` (빈 경우 0 출력)
+
+시간복잡도: O(N log N)
+공간복잡도: O(N)
+
+코드 예시를 보시겠어요? (/algo:hint 정답)"
+```
+
+#### `algo:code-review` - 코드 분석
+
+```
+You: "1927번 내 코드 분석해줘"
+You: [Python 코드 붙여넣기]
+
+Claude: "코드를 분석했습니다! ✨
+
+**✅ 좋은 점:**
+- heapq 모듈을 올바르게 사용
+- 시간복잡도 O(N log N) 달성
+
+**⚠️ 개선 가능:**
+1. `sys.stdin.readline()` 사용 → 입력 속도 개선 (30% 빠름)
+2. 빈 힙 체크를 `if heap:` 대신 `if len(heap):`로 명시
+
+**예상 성능:**
+- 현재: 약 300ms
+- 개선 후: 약 200ms
+
+수정 코드를 보여드릴까요?"
+```
 
-You: "프로그래머스 Level 2 문제 찾아줘"
-Claude: [search_programmers_problems 자동 호출]
+#### `algo:review` - 복습 템플릿
 
-You: "힌트 더 줘"
-Claude: [이전 대화 분석 → 적절한 Level 힌트 제공]
 ```
+You: "1927번 복습 문서 만들어줘"
+
+Claude: "복습 템플릿을 생성했습니다! 📝
+
+# 백준 1927번 - 최소 힙
+
+## 문제 요약
+최솟값을 빠르게 찾는 자료구조 구현
+
+## 핵심 알고리즘
+- **우선순위 큐** (최소 힙)
+- 삽입: O(log N), 삭제: O(log N)
+
+## 풀이 과정
+1. heapq 모듈 import
+2. 입력에 따라 push/pop 수행
+...
+
+이 템플릿을 파일로 저장하시겠어요?"
+```
+
+---
+
+## 학습 워크플로우
+
+### 새 문제 접근하기
+
+```
+1. You: "골드 3~5 DP 문제 추천"
+   → Claude: [문제 3개 추천]
+
+2. You: "1932번 본문 보여줘"
+   → Claude: [문제 본문 표시]
+
+3. You: "힌트 줘"
+   → Claude: [Level 1 힌트]
+
+4. You: "더 구체적으로"
+   → Claude: [Level 2 힌트]
+```
+
+### 풀이 후 복습하기
+
+```
+1. You: "1932번 내 코드 분석해줘" + [코드]
+   → Claude: [시간복잡도, 개선점 제시]
+
+2. You: "복습 문서 만들어줘"
+   → Claude: [마크다운 템플릿 생성]
+```
+
+---
+
+## 사용 방법
+
+### 일반 사용 (자연스러운 대화)
+```
+You: "골드 DP 문제 추천해줘"
+→ Claude가 맥락 파악 → MCP 도구 자동 호출 → 결과 제공
+```
+
+### Skill 사용 (명시적 호출, 권장)
+```
+You: "/algo:search 골드 DP 문제 추천해줘"
+→ Skill이 의도 명확히 파악 → 더 정확한 MCP 도구 선택
+```
+
+**차이점**: 둘 다 MCP 도구를 호출하지만, Skill 사용 시 더 명시적이고 정확한 응답을 받을 수 있습니다.
 
 ## 개발
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "algokit-mcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "type": "module",
   "main": "dist/index.js",
   "bin": {