claude-code-achievements 1.2.2 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ko.md CHANGED
@@ -1,18 +1,24 @@
1
1
  <div align="center">
2
2
 
3
- <img src="assets/icon.png" alt="Claude Code Achievements" width="120" height="120">
3
+ <img src="assets/icon.png" alt="Claude Code Achievements" width="128" height="128">
4
4
 
5
5
  # Claude Code Achievements
6
6
 
7
- **Claude Code를 위한 스팀 스타일 업적 시스템**
7
+ ### AI 코딩 스킬을 레벨업하세요
8
8
 
9
- [![npm version](https://img.shields.io/npm/v/claude-code-achievements.svg?style=flat-square&color=CB3837)](https://www.npmjs.com/package/claude-code-achievements)
10
- [![license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
11
- [![node](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen.svg?style=flat-square)](package.json)
9
+ [![npm version](https://img.shields.io/npm/v/claude-code-achievements.svg?style=for-the-badge&color=FFD700)](https://www.npmjs.com/package/claude-code-achievements)
10
+ [![downloads](https://img.shields.io/npm/dt/claude-code-achievements.svg?style=for-the-badge&color=4CAF50)](https://www.npmjs.com/package/claude-code-achievements)
11
+ [![license](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge)](LICENSE)
12
12
 
13
- 코딩 여정을 게임화하고 Claude Code 기능을 마스터하며 업적을 달성하세요!
13
+ ```
14
+ ╔══════════════════════════════════════════════════════════════╗
15
+ ║ 🎮 업적 달성 • 진행 추적 • 코딩을 게임처럼 🎮 ║
16
+ ╚══════════════════════════════════════════════════════════════╝
17
+ ```
14
18
 
15
- [설치](#설치) · [사용법](#사용법) · [업적](#업적) · [작동 원리](#아키텍처)
19
+ **Claude Code를 RPG 어드벤처로 바꿔보세요!**
20
+
21
+ [빠른 시작](#-빠른-시작) · [업적](#-업적) · [명령어](#-명령어)
16
22
 
17
23
  **[English](README.md)** · **[中文](README.zh.md)** · **[Español](README.es.md)** · **[日本語](README.ja.md)**
18
24
 
@@ -20,296 +26,240 @@
20
26
 
21
27
  ---
22
28
 
23
- ## 기능
29
+ ## ✨ 왜 만들었나요?
24
30
 
25
- - **26개 업적** - 4개 카테고리
26
- - **실시간 알림** - 시스템 알림 또는 터미널
27
- - **다국어 지원** (EN / 中文 / ES / 한국어 / 日本語)
28
- - **크로스 플랫폼** - macOS / Linux / Windows
29
- - **글로벌 설치** - 모든 프로젝트에서 자동 작동
31
+ Claude Code를 배우는 하나의 여정입니다. 이 플러그인은 그 여정을 **게임**으로 만들어줍니다.
30
32
 
31
- ## 설치
33
+ - 🏆 **26개 업적** - 4개의 스킬 트리
34
+ - 🔔 **실시간 알림** - 레벨업할 때마다
35
+ - 📊 **마스터리 추적** - 초보자에서 전문가까지
36
+ - 🌍 **5개 언어** 지원
37
+
38
+ ---
39
+
40
+ ## 🚀 빠른 시작
32
41
 
33
42
  ```bash
34
43
  npx claude-code-achievements
35
44
  ```
36
45
 
37
- 대화형 설치가 진행됩니다:
38
- 1. OS 및 알림 기능 자동 감지
39
- 2. 언어 선택 (English/한국어)
40
- 3. 알림 스타일 설정 (system/terminal/both)
41
- 4. `~/.claude/plugins/local/`에 글로벌 설치
46
+ 끝! 코딩을 시작하면 업적이 알아서 달성됩니다!
47
+
48
+ ---
42
49
 
43
- > **참고:** 이 플러그인은 **글로벌**로 설치되어 모든 프로젝트에서 자동으로 작동합니다.
50
+ ## 🏆 업적
44
51
 
45
- ### 수동 설치
52
+ <table>
53
+ <tr>
54
+ <td width="25%" align="center">
46
55
 
47
- ```bash
48
- git clone https://github.com/subinium/claude-code-achievements.git
49
- cd claude-code-achievements
50
- node bin/install.js
51
- ```
56
+ ### 🌱 시작하기
57
+ **4개 업적**
52
58
 
53
- ## 사용법
59
+ *첫 발걸음*
54
60
 
55
- | 명령어 | 설명 |
56
- |--------|------|
57
- | `/achievements` | 달성한 업적 보기 (기본) |
58
- | `/achievements locked` | 미달성 업적 + 힌트 보기 |
59
- | `/achievements all` | 전체 업적 카테고리별 보기 |
60
- | `/achievements-settings` | 언어 및 알림 설정 변경 |
61
+ </td>
62
+ <td width="25%" align="center">
61
63
 
62
- ### 카테고리 필터
64
+ ### 워크플로우
65
+ **8개 업적**
63
66
 
64
- ```bash
65
- /achievements basics # 시작하기
66
- /achievements workflow # 워크플로우
67
- /achievements tools # 파워 툴
68
- /achievements mastery # 마스터리
69
- ```
67
+ *스마트하게 일하기*
68
+
69
+ </td>
70
+ <td width="25%" align="center">
70
71
 
71
- ## 업적
72
-
73
- <details>
74
- <summary><b>시작하기</b> (4개)</summary>
75
-
76
- | 업적 | 달성 조건 |
77
- |------|----------|
78
- | ✏️ **첫 터치** | 파일 편집하기 |
79
- | 📝 **창조자** | 새 파일 생성하기 |
80
- | 🔍 **코드 탐정** | Glob 또는 Grep으로 검색 |
81
- | 📋 **프로젝트 큐레이터** | `CLAUDE.md` 생성하기 |
82
-
83
- </details>
84
-
85
- <details>
86
- <summary><b>워크플로우</b> (8개)</summary>
87
-
88
- | 업적 | 달성 조건 |
89
- |------|----------|
90
- | 📋 **태스크 플래너** | TodoWrite로 할일 추적 |
91
- | 🎯 **전략적 사고가** | Plan 모드 사용 (`Shift+Tab` 두 번) |
92
- | 🗣️ **소통의 달인** | Claude가 `AskUserQuestion`으로 요구사항 명확화 또는 옵션 제시 |
93
- | 🌍 **글로벌 큐레이터** | `~/.claude/CLAUDE.md` 설정 |
94
- | 📦 **버전 관리자** | Claude와 함께 커밋 |
95
- | 🚀 **배포하기!** | 원격 저장소에 푸시 |
96
- | 🧪 **품질 수호자** | 테스트 실행 |
97
- | 🚦 **CI/CD 개척자** | GitHub Actions 워크플로우 생성 |
98
-
99
- </details>
100
-
101
- <details>
102
- <summary><b>파워 툴</b> (9개)</summary>
103
-
104
- | 업적 | 달성 조건 |
105
- |------|----------|
106
- | 🎨 **비주얼 인스펙터** | 이미지나 스크린샷 분석 |
107
- | 📡 **문서 사냥꾼** | 웹 페이지 가져와서 분석 |
108
- | 🤖 **위임의 달인** | `Task` 도구로 서브 에이전트 생성 |
109
- | 🔌 **MCP 개척자** | MCP 도구 사용 |
110
- | 🌐 **웹 탐험가** | `WebSearch` 사용 |
111
- | ⚙️ **커스터마이저** | Claude Code 설정 수정 |
112
- | 📜 **스킬 창조자** | `.claude/skills/`에 커스텀 스킬 생성 |
113
- | ⌨️ **명령어 장인** | 커스텀 슬래시 명령 생성 |
114
- | 🧩 **플러그인 탐험가** | 마켓플레이스에서 플러그인 설치 |
115
-
116
- </details>
117
-
118
- <details>
119
- <summary><b>마스터리</b> (5개)</summary>
120
-
121
- | 업적 | 달성 조건 |
122
- |------|----------|
123
- | 🪝 **자동화 아키텍트** | Claude Code 훅 설정 |
124
- | 🔗 **MCP 커넥터** | `.mcp.json` 설정 |
125
- | 🤖 **에이전트 설계자** | `.claude/agents/`에 커스텀 에이전트 생성 |
126
- | 🛡️ **보안 수호자** | 보안 권한 설정 |
127
- | 🔄 **루프 마스터** | 자율 코딩 루프 시작 |
128
-
129
- </details>
72
+ ### 🔧 파워 툴
73
+ **9개 업적**
74
+
75
+ *능력 해금*
76
+
77
+ </td>
78
+ <td width="25%" align="center">
79
+
80
+ ### 👑 마스터리
81
+ **5개 업적**
82
+
83
+ *전설이 되다*
84
+
85
+ </td>
86
+ </tr>
87
+ </table>
130
88
 
131
89
  ---
132
90
 
133
- ## 아키텍처
91
+ ### 🌱 시작하기
134
92
 
135
- 플러그인은 **Claude Code의 훅 시스템**을 사용하여 실시간으로 작업을 추적합니다.
93
+ > *모든 마스터도 처음엔 초보자였다*
136
94
 
137
- ```
138
- ┌─────────────────────────────────────────────────────────────┐
139
- │ CLAUDE CODE 세션 │
140
- ├─────────────────────────────────────────────────────────────┤
141
- │ │
142
- │ 사용자: "설정 파일 수정해줘" │
143
- │ │ │
144
- │ ▼ │
145
- │ ┌─────────────────────────────────────┐ │
146
- │ │ Claude가 Edit 도구 사용 │ │
147
- │ └─────────────────────────────────────┘ │
148
- │ │ │
149
- │ ▼ │
150
- │ ┌─────────────────────────────────────┐ │
151
- │ │ PostToolUse 훅 트리거 │◄── hooks.json │
152
- │ │ → track-achievement.sh │ │
153
- │ └─────────────────────────────────────┘ │
154
- │ │ │
155
- │ ┌──────────┴──────────┐ │
156
- │ ▼ ▼ │
157
- │ ┌───────────┐ ┌───────────┐ │
158
- │ │ 매칭! │ │ 매칭 없음 │ │
159
- │ │ │ │ │ │
160
- │ │ 업적 달성 │ │ 계속 진행 │ │
161
- │ │ 알림 표시 │ └───────────┘ │
162
- │ │ 상태 저장 │ │
163
- │ └───────────┘ │
164
- │ │
165
- └─────────────────────────────────────────────────────────────┘
166
- ```
95
+ | | 업적 | 퀘스트 |
96
+ |:--:|------|--------|
97
+ | ✏️ | **첫 터치** | Claude로 파일 편집하기 |
98
+ | 📝 | **창조자** | 새 파일 만들기 |
99
+ | 🔍 | **코드 탐정** | Glob 또는 Grep으로 검색 |
100
+ | 📋 | **프로젝트 큐레이터** | 첫 `CLAUDE.md` 만들기 |
167
101
 
168
- ### 플러그인 구조
102
+ ---
169
103
 
170
- ```
171
- ~/.claude/plugins/local/claude-code-achievements/
172
- ├── .claude-plugin/
173
- │ └── plugin.json # 플러그인 메타데이터
174
- ├── hooks/
175
- │ ├── hooks.json # 훅 정의 (PostToolUse, Stop)
176
- │ ├── track-achievement.sh # 메인 추적 로직
177
- │ └── track-stop.sh # 세션 종료 핸들러
178
- ├── commands/
179
- │ ├── achievements.md # /achievements 명령
180
- │ └── achievements-settings.md
181
- ├── scripts/
182
- │ ├── show-achievements.sh # 화면 표시 UI
183
- │ └── show-notification.sh # 알림 핸들러
184
- └── data/
185
- ├── achievements.json # 업적 정의
186
- └── i18n/
187
- ├── en.json # English
188
- ├── zh.json # 中文
189
- ├── es.json # Español
190
- ├── ko.json # 한국어
191
- └── ja.json # 日本語
192
- ```
104
+ ### ⚡ 워크플로우
193
105
 
194
- ### 작동 방식
106
+ > *효율성은 지적인 게으름이다*
195
107
 
196
- 플러그인은 Claude Code에 개의 훅을 등록합니다:
108
+ | | 업적 | 퀘스트 |
109
+ |:--:|------|--------|
110
+ | 📋 | **태스크 플래너** | TodoWrite로 할일 관리 |
111
+ | 🎯 | **전략적 사고가** | Plan 모드 진입 (`Shift+Tab` × 2) |
112
+ | 🗣️ | **소통의 달인** | Claude가 명확화 질문하기 |
113
+ | 🌍 | **글로벌 큐레이터** | `~/.claude/CLAUDE.md` 설정 |
114
+ | 📦 | **버전 관리자** | Claude와 함께 커밋 |
115
+ | 🚀 | **배포하기!** | 리모트에 푸시 |
116
+ | 🧪 | **품질 수호자** | 테스트 실행 |
117
+ | 🚦 | **CI/CD 개척자** | GitHub Actions 생성 |
197
118
 
198
- | 훅 | 트리거 | 목적 |
199
- |----|--------|------|
200
- | `PostToolUse` | 도구 실행 후 | 업적 달성 조건 확인 |
201
- | `Stop` | 세션 종료 시 | 세션 통계 저장 |
119
+ ---
120
+
121
+ ### 🔧 파워
202
122
 
203
- ### 명령 작동 방식
123
+ > *큰 힘에는 큰 생산성이 따른다*
204
124
 
205
- 슬래시 명령(`/achievements`)은 `~/.claude/commands/`에 있는 **마크다운 파일**로 구현됩니다.
125
+ | | 업적 | 퀘스트 |
126
+ |:--:|------|--------|
127
+ | 🎨 | **비주얼 인스펙터** | 이미지/스크린샷 분석 |
128
+ | 📡 | **문서 사냥꾼** | 웹 페이지 가져와서 분석 |
129
+ | 🤖 | **위임의 달인** | Task로 서브 에이전트 생성 |
130
+ | 🔌 | **MCP 개척자** | MCP 도구 사용 |
131
+ | 🌐 | **웹 탐험가** | 웹 검색 |
132
+ | ⚙️ | **커스터마이저** | Claude Code 설정 수정 |
133
+ | 📜 | **스킬 창조자** | 커스텀 스킬 생성 |
134
+ | ⌨️ | **명령어 장인** | 커스텀 슬래시 명령 생성 |
135
+ | 🧩 | **플러그인 탐험가** | 마켓플레이스에서 플러그인 설치 |
206
136
 
207
137
  ---
208
138
 
209
- ## 알림
139
+ ### 👑 마스터리
210
140
 
211
- 시스템 알림은 설치 자동 감지됩니다:
141
+ > *한계를 넘어서는 소수의 엘리트*
212
142
 
213
- | OS | 방식 | 사운드 |
214
- |----|------|--------|
215
- | macOS | `osascript` | Glass |
216
- | Linux | `notify-send` | 시스템 기본 |
217
- | Windows | PowerShell | 시스템 기본 |
218
- | 폴백 | 터미널 | 없음 |
143
+ | | 업적 | 퀘스트 |
144
+ |:--:|------|--------|
145
+ | 🪝 | **자동화 아키텍트** | Claude Code 훅 설정 |
146
+ | 🔗 | **MCP 커넥터** | `.mcp.json` 통합 설정 |
147
+ | 🤖 | **에이전트 설계자** | 커스텀 에이전트 생성 |
148
+ | 🛡️ | **보안 수호자** | 보안 권한 설정 |
149
+ | 🔄 | **루프 마스터** | 자율 코딩 루프 시작 |
219
150
 
220
- ### Linux에서 notify-send 설치
151
+ ---
152
+
153
+ ## 🎮 명령어
221
154
 
222
155
  ```bash
223
- # Ubuntu/Debian
224
- sudo apt install libnotify-bin
156
+ /achievements # 달성한 업적 보기
157
+ /achievements locked # 미달성 업적 + 힌트 보기
158
+ /achievements all # 전체 업적 카테고리별 보기
159
+ /achievements-settings # 언어 및 알림 설정
160
+ ```
225
161
 
226
- # Fedora
227
- sudo dnf install libnotify
162
+ ### 카테고리 필터
228
163
 
229
- # Arch
230
- sudo pacman -S libnotify
164
+ ```bash
165
+ /achievements basics # 🌱 시작하기
166
+ /achievements workflow # ⚡ 워크플로우
167
+ /achievements tools # 🔧 파워 툴
168
+ /achievements mastery # 👑 마스터리
231
169
  ```
232
170
 
233
171
  ---
234
172
 
235
- ## 설정
173
+ ## 🔔 알림
236
174
 
237
- 설정은 `~/.claude/achievements/state.json`에 저장됩니다:
175
+ 업적 달성 시 바로 알려드립니다!
176
+
177
+ | 플랫폼 | 스타일 |
178
+ |--------|--------|
179
+ | 🍎 macOS | 네이티브 알림 + 사운드 |
180
+ | 🐧 Linux | 시스템 알림 |
181
+ | 🪟 Windows | 토스트 알림 |
182
+ | 💻 폴백 | 터미널 알림 |
183
+
184
+ ---
238
185
 
239
- ```json
240
- {
241
- "settings": {
242
- "language": "ko",
243
- "notifications": true,
244
- "notification_style": "system"
245
- },
246
- "achievements": {},
247
- "counters": {}
248
- }
186
+ ## 🛠️ 작동 원리
187
+
188
+ ```
189
+ You: "설정 파일 수정해줘"
190
+
191
+
192
+ ┌─────────────────────┐
193
+ Claude가 Edit 사용 │
194
+ └─────────────────────┘
195
+
196
+
197
+ ┌─────────────────────┐
198
+ │ 🎯 훅 트리거 │──▶ 업적 체크
199
+ └─────────────────────┘
200
+
201
+ ┌──────┴──────┐
202
+ ▼ ▼
203
+ ┌───────┐ ┌────────┐
204
+ │ 🏆 +1 │ │ None │
205
+ │ 달성! │ │ 계속 │
206
+ └───────┘ └────────┘
249
207
  ```
250
208
 
251
- | 설정 | | 설명 |
252
- |------|-----|------|
253
- | `language` | `"en"`, `"zh"`, `"es"`, `"ko"`, `"ja"` | UI 언어 |
254
- | `notifications` | `true`, `false` | 알림 활성화/비활성화 |
255
- | `notification_style` | `"system"`, `"terminal"`, `"both"` | 알림 방식 |
209
+ 플러그인은 Claude Code의 이벤트 시스템에 연결됩니다. 모든 도구 사용이 추적되고, 마일스톤에 도달하면 보상을 받습니다!
256
210
 
257
211
  ---
258
212
 
259
- ## 문제 해결
213
+ ## 🌍 지원 언어
260
214
 
261
- <details>
262
- <summary><b>업적이 달성되지 않나요?</b></summary>
215
+ - 🇺🇸 English
216
+ - 🇨🇳 中文
217
+ - 🇪🇸 Español
218
+ - 🇰🇷 한국어
219
+ - 🇯🇵 日本語
263
220
 
264
- ```bash
265
- # 플러그인 설치 확인
266
- ls ~/.claude/plugins/local/claude-code-achievements/
221
+ `/achievements-settings`로 언제든 변경 가능
267
222
 
268
- # 상태 파일 확인
269
- cat ~/.claude/achievements/state.json
223
+ ---
270
224
 
271
- # 훅이 로드되었는지 확인 (설치 후 Claude Code 재시작)
272
- ```
225
+ ## 📂 진행 상황
273
226
 
274
- </details>
227
+ 모든 진행 상황은 로컬에 저장됩니다:
275
228
 
276
- <details>
277
- <summary><b>진행 상황 초기화</b></summary>
229
+ ```
230
+ ~/.claude/achievements/state.json
231
+ ```
278
232
 
233
+ 여정을 다시 시작하려면:
279
234
  ```bash
280
235
  rm ~/.claude/achievements/state.json
281
236
  ```
282
237
 
283
- </details>
238
+ ---
284
239
 
285
- <details>
286
- <summary><b>플러그인 재설치</b></summary>
240
+ ## 🤝 기여하기
287
241
 
288
- ```bash
289
- npx claude-code-achievements@latest
290
- ```
242
+ 새로운 업적 아이디어가 있나요? 버그를 발견했나요? 기여를 환영합니다!
291
243
 
292
- </details>
244
+ - 🏆 새 업적 제안
245
+ - 🌍 번역 추가
246
+ - 🐛 이슈 리포트
247
+ - ⭐ 스타 눌러주기!
293
248
 
294
249
  ---
295
250
 
296
- ## 기여하기
297
-
298
- 기여를 환영합니다! 아이디어:
251
+ <div align="center">
299
252
 
300
- - 새로운 업적
301
- - 새로운 언어 번역
302
- - UI 개선
303
- - 버그 수정
253
+ ### 여정을 시작할 준비가 되셨나요?
304
254
 
305
- ## 라이선스
255
+ ```bash
256
+ npx claude-code-achievements
257
+ ```
306
258
 
307
- MIT © [subinium](https://github.com/subinium)
259
+ **레벨업하고, 업적을 달성하고, 즐겁게 코딩하세요!**
308
260
 
309
261
  ---
310
262
 
311
- <div align="center">
312
-
313
- **Happy coding!**
263
+ MIT © [subinium](https://github.com/subinium)
314
264
 
315
265
  </div>