claude-code-achievements 1.2.2 → 1.2.4

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.
Files changed (9) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/README.es.md +177 -227
  3. package/README.ja.md +177 -227
  4. package/README.ko.md +177 -227
  5. package/README.md +177 -227
  6. package/README.zh.md +177 -227
  7. package/bin/install.js +79 -61
  8. package/hooks/track-achievement.sh +2 -1
  9. package/package.json +1 -1
package/.claude-plugin/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-code-achievements",
3
- "version": "1.2.2",
3
+ "version": "1.2.4",
4
4
  "description": "Steam-style achievement system for Claude Code",
5
5
  "author": {
6
6
  "name": "subinium"
package/README.es.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
- **Sistema de logros estilo Steam para Claude Code**
7
+ ### Sube de nivel tus habilidades de codificación con IA
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
- ¡Gamifica tu experiencia de programación y desbloquea logros mientras dominas las funciones de Claude Code!
13
+ ```
14
+ ╔══════════════════════════════════════════════════════════════╗
15
+ ║ 🎮 DESBLOQUEA LOGROS • RASTREA PROGRESO • DIVIÉRTETE 🎮 ║
16
+ ╚══════════════════════════════════════════════════════════════╝
17
+ ```
14
18
 
15
- [Instalación](#instalación) · [Uso](#uso) · [Logros](#logros) · [Cómo Funciona](#arquitectura)
19
+ **¡Transforma tu experiencia con Claude Code en una aventura RPG!**
20
+
21
+ [Inicio Rápido](#-inicio-rápido) · [Logros](#-logros) · [Comandos](#-comandos)
16
22
 
17
23
  **[English](README.md)** · **[中文](README.zh.md)** · **[한국어](README.ko.md)** · **[日本語](README.ja.md)**
18
24
 
@@ -20,296 +26,240 @@
20
26
 
21
27
  ---
22
28
 
23
- ## Características
29
+ ## ✨ ¿Por Qué Existe Esto?
24
30
 
25
- - **26 Logros** en 4 categorías
26
- - **Notificaciones en tiempo real** vía alertas del sistema o terminal
27
- - **Soporte multiidioma** (EN / 中文 / ES / 한국어 / 日本語)
28
- - **Multiplataforma** (macOS / Linux / Windows)
29
- - **Instalación global** - funciona en todos tus proyectos
31
+ Aprender Claude Code es un viaje. Este plugin convierte ese viaje en un **juego**.
30
32
 
31
- ## Instalación
33
+ - 🏆 **26 Logros** en 4 árboles de habilidades
34
+ - 🔔 **Notificaciones en tiempo real** cuando subes de nivel
35
+ - 📊 **Rastrea tu maestría** de principiante a experto
36
+ - 🌍 **5 Idiomas** soportados
37
+
38
+ ---
39
+
40
+ ## 🚀 Inicio Rápido
32
41
 
33
42
  ```bash
34
43
  npx claude-code-achievements
35
44
  ```
36
45
 
37
- El instalador interactivo:
38
- 1. Detectará automáticamente tu SO y capacidad de notificaciones
39
- 2. Preguntará tu preferencia de idioma
40
- 3. Configurará el estilo de notificación (sistema/terminal/ambos)
41
- 4. Instalará globalmente en `~/.claude/plugins/local/`
46
+ ¡Eso es todo! ¡Empieza a programar y mira cómo llegan los logros!
42
47
 
43
- > **Nota:** Este plugin se instala **globalmente** y funciona automáticamente en todos tus proyectos.
48
+ ---
44
49
 
45
- ### Instalación Manual
50
+ ## 🏆 Logros
46
51
 
47
- ```bash
48
- git clone https://github.com/subinium/claude-code-achievements.git
49
- cd claude-code-achievements
50
- node bin/install.js
51
- ```
52
+ <table>
53
+ <tr>
54
+ <td width="25%" align="center">
52
55
 
53
- ## Uso
56
+ ### 🌱 Primeros Pasos
57
+ **4 Logros**
54
58
 
55
- | Comando | Descripción |
56
- |---------|-------------|
57
- | `/achievements` | Ver logros desbloqueados (predeterminado) |
58
- | `/achievements locked` | Ver logros bloqueados con pistas |
59
- | `/achievements all` | Ver todos los logros por categoría |
60
- | `/achievements-settings` | Cambiar idioma o configuración de notificaciones |
59
+ *Tus primeros pasos*
61
60
 
62
- ### Filtros de Categoría
61
+ </td>
62
+ <td width="25%" align="center">
63
63
 
64
- ```bash
65
- /achievements basics # Primeros Pasos
66
- /achievements workflow # Flujo de Trabajo
67
- /achievements tools # Herramientas Avanzadas
68
- /achievements mastery # Maestría
69
- ```
64
+ ### ⚡ Flujo de Trabajo
65
+ **8 Logros**
66
+
67
+ *Trabaja más inteligente*
68
+
69
+ </td>
70
+ <td width="25%" align="center">
70
71
 
71
- ## Logros
72
-
73
- <details>
74
- <summary><b>Primeros Pasos</b> (4 logros)</summary>
75
-
76
- | Logro | Cómo Desbloquear |
77
- |-------|------------------|
78
- | ✏️ **Primer Toque** | Editar cualquier archivo |
79
- | 📝 **Creador** | Crear un nuevo archivo |
80
- | 🔍 **Detective de Código** | Usar Glob o Grep para buscar en el código |
81
- | 📋 **Curador de Proyecto** | Crear `CLAUDE.md` para contexto del proyecto |
82
-
83
- </details>
84
-
85
- <details>
86
- <summary><b>Flujo de Trabajo</b> (8 logros)</summary>
87
-
88
- | Logro | Cómo Desbloquear |
89
- |-------|------------------|
90
- | 📋 **Planificador de Tareas** | Usar TodoWrite para seguimiento de tareas |
91
- | 🎯 **Pensador Estratégico** | Usar modo Plan (`Shift+Tab` dos veces) |
92
- | 🗣️ **Comunicador** | Claude usa `AskUserQuestion` para clarificar requisitos |
93
- | 🌍 **Curador Global** | Configurar `~/.claude/CLAUDE.md` |
94
- | 📦 **Controlador de Versiones** | Hacer commit con Claude |
95
- | 🚀 **¡A Producción!** | Hacer push al repositorio remoto |
96
- | 🧪 **Guardián de Calidad** | Ejecutar tests con Claude |
97
- | 🚦 **Pionero CI/CD** | Crear workflow de GitHub Actions |
98
-
99
- </details>
100
-
101
- <details>
102
- <summary><b>Herramientas Avanzadas</b> (9 logros)</summary>
103
-
104
- | Logro | Cómo Desbloquear |
105
- |-------|------------------|
106
- | 🎨 **Inspector Visual** | Analizar imagen o captura de pantalla |
107
- | 📡 **Cazador de Docs** | Obtener y analizar una página web |
108
- | 🤖 **Maestro de Delegación** | Usar herramienta `Task` para sub-agentes |
109
- | 🔌 **Pionero MCP** | Usar cualquier herramienta MCP |
110
- | 🌐 **Explorador Web** | Usar herramienta `WebSearch` |
111
- | ⚙️ **Personalizador** | Modificar configuración de Claude Code |
112
- | 📜 **Creador de Skills** | Crear skill personalizado en `.claude/skills/` |
113
- | ⌨️ **Artesano de Comandos** | Crear comando slash personalizado |
114
- | 🧩 **Explorador de Plugins** | Instalar un plugin desde el marketplace |
115
-
116
- </details>
117
-
118
- <details>
119
- <summary><b>Maestría</b> (5 logros)</summary>
120
-
121
- | Logro | Cómo Desbloquear |
122
- |-------|------------------|
123
- | 🪝 **Arquitecto de Automatización** | Configurar hooks de Claude Code |
124
- | 🔗 **Conector MCP** | Configurar `.mcp.json` para integraciones |
125
- | 🤖 **Arquitecto de Agentes** | Crear agente personalizado en `.claude/agents/` |
126
- | 🛡️ **Guardia de Seguridad** | Configurar permisos de seguridad |
127
- | 🔄 **Maestro del Bucle** | Iniciar bucle de codificación autónomo |
128
-
129
- </details>
72
+ ### 🔧 Herramientas Avanzadas
73
+ **9 Logros**
74
+
75
+ *Desbloquea habilidades*
76
+
77
+ </td>
78
+ <td width="25%" align="center">
79
+
80
+ ### 👑 Maestría
81
+ **5 Logros**
82
+
83
+ *Conviértete en leyenda*
84
+
85
+ </td>
86
+ </tr>
87
+ </table>
130
88
 
131
89
  ---
132
90
 
133
- ## Arquitectura
91
+ ### 🌱 Primeros Pasos
134
92
 
135
- Este plugin usa el **sistema de hooks de Claude Code** para rastrear tus acciones en tiempo real.
93
+ > *Todo maestro fue una vez principiante*
136
94
 
137
- ```
138
- ┌─────────────────────────────────────────────────────────────┐
139
- │ SESIÓN DE CLAUDE CODE │
140
- ├─────────────────────────────────────────────────────────────┤
141
- │ │
142
- │ Tú: "Edita el archivo de configuración" │
143
- │ │ │
144
- │ ▼ │
145
- │ ┌─────────────────────────────────────┐ │
146
- │ │ Claude usa la herramienta Edit │ │
147
- │ └─────────────────────────────────────┘ │
148
- │ │ │
149
- │ ▼ │
150
- │ ┌─────────────────────────────────────┐ │
151
- │ │ Se activa el Hook PostToolUse │◄── hooks.json │
152
- │ │ → track-achievement.sh │ │
153
- │ └─────────────────────────────────────┘ │
154
- │ │ │
155
- │ ┌──────────┴──────────┐ │
156
- │ ▼ ▼ │
157
- │ ┌───────────┐ ┌───────────┐ │
158
- │ │ ¡Coincide!│ │ No coincide│ │
159
- │ │ │ │ │ │
160
- │ │ Desbloquear│ │ Continuar │ │
161
- │ │ Notificar │ └───────────┘ │
162
- │ │ Guardar │ │
163
- │ └───────────┘ │
164
- │ │
165
- └─────────────────────────────────────────────────────────────┘
166
- ```
95
+ | | Logro | Misión |
96
+ |:--:|-------|--------|
97
+ | ✏️ | **Primer Toque** | Edita cualquier archivo con Claude |
98
+ | 📝 | **Creador** | Crea un nuevo archivo |
99
+ | 🔍 | **Detective de Código** | Busca con Glob o Grep |
100
+ | 📋 | **Curador de Proyecto** | Crea tu primer `CLAUDE.md` |
167
101
 
168
- ### Estructura del Plugin
102
+ ---
169
103
 
170
- ```
171
- ~/.claude/plugins/local/claude-code-achievements/
172
- ├── .claude-plugin/
173
- │ └── plugin.json # Metadatos del plugin
174
- ├── hooks/
175
- │ ├── hooks.json # Definiciones de hooks (PostToolUse, Stop)
176
- │ ├── track-achievement.sh # Lógica principal de seguimiento
177
- │ └── track-stop.sh # Manejador de fin de sesión
178
- ├── commands/
179
- │ ├── achievements.md # Comando /achievements
180
- │ └── achievements-settings.md
181
- ├── scripts/
182
- │ ├── show-achievements.sh # UI de visualización
183
- │ └── show-notification.sh # Manejador de notificaciones
184
- └── data/
185
- ├── achievements.json # Definiciones de logros
186
- └── i18n/
187
- ├── en.json # English
188
- ├── zh.json # 中文
189
- ├── es.json # Español
190
- ├── ko.json # 한국어
191
- └── ja.json # 日本語
192
- ```
104
+ ### ⚡ Flujo de Trabajo
193
105
 
194
- ### Cómo Funcionan los Hooks
106
+ > *La eficiencia es pereza inteligente*
195
107
 
196
- El plugin registra dos hooks en Claude Code:
108
+ | | Logro | Misión |
109
+ |:--:|-------|--------|
110
+ | 📋 | **Planificador de Tareas** | Usa TodoWrite para gestionar tareas |
111
+ | 🎯 | **Pensador Estratégico** | Entra en modo Plan (`Shift+Tab` × 2) |
112
+ | 🗣️ | **Comunicador** | Haz que Claude te haga una pregunta aclaratoria |
113
+ | 🌍 | **Curador Global** | Configura `~/.claude/CLAUDE.md` |
114
+ | 📦 | **Controlador de Versiones** | Haz un commit con Claude |
115
+ | 🚀 | **¡Despliega!** | Haz push al remoto |
116
+ | 🧪 | **Guardián de Calidad** | Ejecuta tests |
117
+ | 🚦 | **Pionero CI/CD** | Crea workflow de GitHub Actions |
197
118
 
198
- | Hook | Activador | Propósito |
199
- |------|-----------|-----------|
200
- | `PostToolUse` | Después de ejecutar herramienta | Verificar condiciones de logro |
201
- | `Stop` | Al finalizar sesión | Guardar estadísticas de sesión |
119
+ ---
120
+
121
+ ### 🔧 Herramientas Avanzadas
202
122
 
203
- ### Cómo Funcionan los Comandos
123
+ > *Con gran poder viene gran productividad*
204
124
 
205
- Los comandos slash (`/achievements`) se implementan como **archivos Markdown** en `~/.claude/commands/`.
125
+ | | Logro | Misión |
126
+ |:--:|-------|--------|
127
+ | 🎨 | **Inspector Visual** | Analiza una imagen o captura |
128
+ | 📡 | **Cazador de Docs** | Obtén y analiza una página web |
129
+ | 🤖 | **Maestro de Delegación** | Genera un sub-agente con Task |
130
+ | 🔌 | **Pionero MCP** | Usa cualquier herramienta MCP |
131
+ | 🌐 | **Explorador Web** | Busca en la web |
132
+ | ⚙️ | **Personalizador** | Modifica configuración de Claude Code |
133
+ | 📜 | **Creador de Skills** | Crea un skill personalizado |
134
+ | ⌨️ | **Artesano de Comandos** | Crea un comando slash personalizado |
135
+ | 🧩 | **Explorador de Plugins** | Instala un plugin del marketplace |
206
136
 
207
137
  ---
208
138
 
209
- ## Notificaciones
139
+ ### 👑 Maestría
210
140
 
211
- Las notificaciones del sistema se detectan automáticamente durante la instalación:
141
+ > *La élite que supera los límites*
212
142
 
213
- | SO | Método | Sonido |
214
- |----|--------|--------|
215
- | macOS | `osascript` | Glass |
216
- | Linux | `notify-send` | Predeterminado del sistema |
217
- | Windows | PowerShell | Predeterminado del sistema |
218
- | Alternativa | Terminal | Ninguno |
143
+ | | Logro | Misión |
144
+ |:--:|-------|--------|
145
+ | 🪝 | **Arquitecto de Automatización** | Configura hooks de Claude Code |
146
+ | 🔗 | **Conector MCP** | Configura integración `.mcp.json` |
147
+ | 🤖 | **Arquitecto de Agentes** | Crea un agente personalizado |
148
+ | 🛡️ | **Guardia de Seguridad** | Configura permisos de seguridad |
149
+ | 🔄 | **Maestro del Loop** | Inicia un loop de codificación autónomo |
219
150
 
220
- ### Instalar notify-send en Linux
151
+ ---
152
+
153
+ ## 🎮 Comandos
221
154
 
222
155
  ```bash
223
- # Ubuntu/Debian
224
- sudo apt install libnotify-bin
156
+ /achievements # Ver logros desbloqueados
157
+ /achievements locked # Ver logros bloqueados + pistas
158
+ /achievements all # Lista completa por categoría
159
+ /achievements-settings # Configurar idioma y notificaciones
160
+ ```
225
161
 
226
- # Fedora
227
- sudo dnf install libnotify
162
+ ### Filtros por Categoría
228
163
 
229
- # Arch
230
- sudo pacman -S libnotify
164
+ ```bash
165
+ /achievements basics # 🌱 Primeros Pasos
166
+ /achievements workflow # ⚡ Flujo de Trabajo
167
+ /achievements tools # 🔧 Herramientas Avanzadas
168
+ /achievements mastery # 👑 Maestría
231
169
  ```
232
170
 
233
171
  ---
234
172
 
235
- ## Configuración
173
+ ## 🔔 Notificaciones
174
+
175
+ ¿Logro desbloqueado? ¡Lo sabrás al instante!
176
+
177
+ | Plataforma | Estilo |
178
+ |------------|--------|
179
+ | 🍎 macOS | Notificación nativa con sonido |
180
+ | 🐧 Linux | Notificación del sistema |
181
+ | 🪟 Windows | Notificación toast |
182
+ | 💻 Respaldo | Alerta en terminal |
183
+
184
+ ---
236
185
 
237
- La configuración se guarda en `~/.claude/achievements/state.json`:
186
+ ## 🛠️ Cómo Funciona
238
187
 
239
- ```json
240
- {
241
- "settings": {
242
- "language": "es",
243
- "notifications": true,
244
- "notification_style": "system"
245
- },
246
- "achievements": {},
247
- "counters": {}
248
- }
188
+ ```
189
+ Tú: "Edita el archivo de configuración"
190
+ │
191
+ ▼
192
+ ┌─────────────────────┐
193
+ │ Claude usa Edit │
194
+ └─────────────────────┘
195
+ │
196
+ ▼
197
+ ┌─────────────────────┐
198
+ │ 🎯 Hook activado │──▶ Verificación de logro
199
+ └─────────────────────┘
200
+ │
201
+ ┌──────┴──────┐
202
+ ▼ ▼
203
+ ┌───────┐ ┌────────┐
204
+ │ 🏆 +1 │ │ Ninguno│
205
+ │Desbloq│ │Continúa│
206
+ └───────┘ └────────┘
249
207
  ```
250
208
 
251
- | Configuración | Valores | Descripción |
252
- |---------------|---------|-------------|
253
- | `language` | `"en"`, `"zh"`, `"es"`, `"ko"`, `"ja"` | Idioma de la interfaz |
254
- | `notifications` | `true`, `false` | Activar/desactivar alertas |
255
- | `notification_style` | `"system"`, `"terminal"`, `"both"` | Método de alerta |
209
+ El plugin se conecta al sistema de eventos de Claude Code. Cada uso de herramienta se rastrea. ¡Cuando alcanzas un hito, recibes tu recompensa!
256
210
 
257
211
  ---
258
212
 
259
- ## Solución de Problemas
213
+ ## 🌍 Idiomas
260
214
 
261
- <details>
262
- <summary><b>¿Los logros no se desbloquean?</b></summary>
215
+ - 🇺🇸 English
216
+ - 🇨🇳 中文
217
+ - 🇪🇸 Español
218
+ - 🇰🇷 한국어
219
+ - 🇯🇵 日本語
263
220
 
264
- ```bash
265
- # Verificar que el plugin está instalado
266
- ls ~/.claude/plugins/local/claude-code-achievements/
221
+ Cambia en cualquier momento con `/achievements-settings`
267
222
 
268
- # Verificar que existe el archivo de estado
269
- cat ~/.claude/achievements/state.json
223
+ ---
270
224
 
271
- # Reiniciar Claude Code después de la instalación para cargar los hooks
272
- ```
225
+ ## 📂 Tu Progreso
273
226
 
274
- </details>
227
+ Todo el progreso se guarda localmente:
275
228
 
276
- <details>
277
- <summary><b>Reiniciar todo el progreso</b></summary>
229
+ ```
230
+ ~/.claude/achievements/state.json
231
+ ```
278
232
 
233
+ Reinicia tu viaje en cualquier momento:
279
234
  ```bash
280
235
  rm ~/.claude/achievements/state.json
281
236
  ```
282
237
 
283
- </details>
238
+ ---
284
239
 
285
- <details>
286
- <summary><b>Reinstalar el plugin</b></summary>
240
+ ## 🤝 Contribuir
287
241
 
288
- ```bash
289
- npx claude-code-achievements@latest
290
- ```
242
+ ¿Tienes una idea para un nuevo logro? ¿Encontraste un bug? ¡Las contribuciones son bienvenidas!
291
243
 
292
- </details>
244
+ - 🏆 Sugiere nuevos logros
245
+ - 🌍 Añade traducciones
246
+ - 🐛 Reporta problemas
247
+ - ⭐ ¡Dale una estrella al repo!
293
248
 
294
249
  ---
295
250
 
296
- ## Contribuir
297
-
298
- ¡Las contribuciones son bienvenidas! Ideas:
251
+ <div align="center">
299
252
 
300
- - Nuevos logros
301
- - Nuevas traducciones de idiomas
302
- - Mejoras de UI
303
- - Corrección de errores
253
+ ### ¿Listo para comenzar tu viaje?
304
254
 
305
- ## Licencia
255
+ ```bash
256
+ npx claude-code-achievements
257
+ ```
306
258
 
307
- MIT © [subinium](https://github.com/subinium)
259
+ **¡Sube de nivel. Desbloquea logros. Diviértete programando!**
308
260
 
309
261
  ---
310
262
 
311
- <div align="center">
312
-
313
- **¡Feliz programación!**
263
+ MIT © [subinium](https://github.com/subinium)
314
264
 
315
265
  </div>