claude-code-achievements 1.2.1 → 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.
Files changed (16) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/README.es.md +177 -228
  3. package/README.ja.md +177 -228
  4. package/README.ko.md +177 -228
  5. package/README.md +177 -228
  6. package/README.zh.md +177 -228
  7. package/bin/install.js +79 -61
  8. package/commands/achievements.md +28 -23
  9. package/data/achievements.json +0 -8
  10. package/data/i18n/en.json +0 -5
  11. package/data/i18n/es.json +0 -5
  12. package/data/i18n/ja.json +0 -5
  13. package/data/i18n/ko.json +0 -5
  14. package/data/i18n/zh.json +0 -5
  15. package/hooks/track-achievement.sh +12 -8
  16. 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.1.0",
3
+ "version": "1.2.3",
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,297 +26,240 @@
20
26
 
21
27
  ---
22
28
 
23
- ## Características
29
+ ## ✨ ¿Por Qué Existe Esto?
24
30
 
25
- - **27 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> (10 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
- | ⚡ **Maestro de Habilidades** | Usar comandos slash skills |
112
- | ⚙️ **Personalizador** | Modificar configuración de Claude Code |
113
- | 📜 **Creador de Skills** | Crear skill personalizado en `.claude/skills/` |
114
- | ⌨️ **Artesano de Comandos** | Crear comando slash personalizado |
115
- | 🧩 **Explorador de Plugins** | Instalar un plugin desde el marketplace |
116
-
117
- </details>
118
-
119
- <details>
120
- <summary><b>Maestría</b> (5 logros)</summary>
121
-
122
- | Logro | Cómo Desbloquear |
123
- |-------|------------------|
124
- | 🪝 **Arquitecto de Automatización** | Configurar hooks de Claude Code |
125
- | 🔗 **Conector MCP** | Configurar `.mcp.json` para integraciones |
126
- | 🤖 **Arquitecto de Agentes** | Crear agente personalizado en `.claude/agents/` |
127
- | 🛡️ **Guardia de Seguridad** | Configurar permisos de seguridad |
128
- | 🔄 **Maestro del Bucle** | Iniciar bucle de codificación autónomo |
129
-
130
- </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>
131
88
 
132
89
  ---
133
90
 
134
- ## Arquitectura
91
+ ### 🌱 Primeros Pasos
135
92
 
136
- Este plugin usa el **sistema de hooks de Claude Code** para rastrear tus acciones en tiempo real.
93
+ > *Todo maestro fue una vez principiante*
137
94
 
138
- ```
139
- ┌─────────────────────────────────────────────────────────────┐
140
- │ SESIÓN DE CLAUDE CODE │
141
- ├─────────────────────────────────────────────────────────────┤
142
- │ │
143
- │ Tú: "Edita el archivo de configuración" │
144
- │ │ │
145
- │ ▼ │
146
- │ ┌─────────────────────────────────────┐ │
147
- │ │ Claude usa la herramienta Edit │ │
148
- │ └─────────────────────────────────────┘ │
149
- │ │ │
150
- │ ▼ │
151
- │ ┌─────────────────────────────────────┐ │
152
- │ │ Se activa el Hook PostToolUse │◄── hooks.json │
153
- │ │ → track-achievement.sh │ │
154
- │ └─────────────────────────────────────┘ │
155
- │ │ │
156
- │ ┌──────────┴──────────┐ │
157
- │ ▼ ▼ │
158
- │ ┌───────────┐ ┌───────────┐ │
159
- │ │ ¡Coincide!│ │ No coincide│ │
160
- │ │ │ │ │ │
161
- │ │ Desbloquear│ │ Continuar │ │
162
- │ │ Notificar │ └───────────┘ │
163
- │ │ Guardar │ │
164
- │ └───────────┘ │
165
- │ │
166
- └─────────────────────────────────────────────────────────────┘
167
- ```
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` |
168
101
 
169
- ### Estructura del Plugin
102
+ ---
170
103
 
171
- ```
172
- ~/.claude/plugins/local/claude-code-achievements/
173
- ├── .claude-plugin/
174
- │ └── plugin.json # Metadatos del plugin
175
- ├── hooks/
176
- │ ├── hooks.json # Definiciones de hooks (PostToolUse, Stop)
177
- │ ├── track-achievement.sh # Lógica principal de seguimiento
178
- │ └── track-stop.sh # Manejador de fin de sesión
179
- ├── commands/
180
- │ ├── achievements.md # Comando /achievements
181
- │ └── achievements-settings.md
182
- ├── scripts/
183
- │ ├── show-achievements.sh # UI de visualización
184
- │ └── show-notification.sh # Manejador de notificaciones
185
- └── data/
186
- ├── achievements.json # Definiciones de logros
187
- └── i18n/
188
- ├── en.json # English
189
- ├── zh.json # 中文
190
- ├── es.json # Español
191
- ├── ko.json # 한국어
192
- └── ja.json # 日本語
193
- ```
104
+ ### ⚡ Flujo de Trabajo
194
105
 
195
- ### Cómo Funcionan los Hooks
106
+ > *La eficiencia es pereza inteligente*
196
107
 
197
- 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 |
198
118
 
199
- | Hook | Activador | Propósito |
200
- |------|-----------|-----------|
201
- | `PostToolUse` | Después de ejecutar herramienta | Verificar condiciones de logro |
202
- | `Stop` | Al finalizar sesión | Guardar estadísticas de sesión |
119
+ ---
120
+
121
+ ### 🔧 Herramientas Avanzadas
203
122
 
204
- ### Cómo Funcionan los Comandos
123
+ > *Con gran poder viene gran productividad*
205
124
 
206
- 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 |
207
136
 
208
137
  ---
209
138
 
210
- ## Notificaciones
139
+ ### 👑 Maestría
211
140
 
212
- Las notificaciones del sistema se detectan automáticamente durante la instalación:
141
+ > *La élite que supera los límites*
213
142
 
214
- | SO | Método | Sonido |
215
- |----|--------|--------|
216
- | macOS | `osascript` | Glass |
217
- | Linux | `notify-send` | Predeterminado del sistema |
218
- | Windows | PowerShell | Predeterminado del sistema |
219
- | 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 |
220
150
 
221
- ### Instalar notify-send en Linux
151
+ ---
152
+
153
+ ## 🎮 Comandos
222
154
 
223
155
  ```bash
224
- # Ubuntu/Debian
225
- 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
+ ```
226
161
 
227
- # Fedora
228
- sudo dnf install libnotify
162
+ ### Filtros por Categoría
229
163
 
230
- # Arch
231
- 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
232
169
  ```
233
170
 
234
171
  ---
235
172
 
236
- ## 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
+ ---
237
185
 
238
- La configuración se guarda en `~/.claude/achievements/state.json`:
186
+ ## 🛠️ Cómo Funciona
239
187
 
240
- ```json
241
- {
242
- "settings": {
243
- "language": "es",
244
- "notifications": true,
245
- "notification_style": "system"
246
- },
247
- "achievements": {},
248
- "counters": {}
249
- }
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
+ └───────┘ └────────┘
250
207
  ```
251
208
 
252
- | Configuración | Valores | Descripción |
253
- |---------------|---------|-------------|
254
- | `language` | `"en"`, `"zh"`, `"es"`, `"ko"`, `"ja"` | Idioma de la interfaz |
255
- | `notifications` | `true`, `false` | Activar/desactivar alertas |
256
- | `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!
257
210
 
258
211
  ---
259
212
 
260
- ## Solución de Problemas
213
+ ## 🌍 Idiomas
261
214
 
262
- <details>
263
- <summary><b>¿Los logros no se desbloquean?</b></summary>
215
+ - 🇺🇸 English
216
+ - 🇨🇳 中文
217
+ - 🇪🇸 Español
218
+ - 🇰🇷 한국어
219
+ - 🇯🇵 日本語
264
220
 
265
- ```bash
266
- # Verificar que el plugin está instalado
267
- ls ~/.claude/plugins/local/claude-code-achievements/
221
+ Cambia en cualquier momento con `/achievements-settings`
268
222
 
269
- # Verificar que existe el archivo de estado
270
- cat ~/.claude/achievements/state.json
223
+ ---
271
224
 
272
- # Reiniciar Claude Code después de la instalación para cargar los hooks
273
- ```
225
+ ## 📂 Tu Progreso
274
226
 
275
- </details>
227
+ Todo el progreso se guarda localmente:
276
228
 
277
- <details>
278
- <summary><b>Reiniciar todo el progreso</b></summary>
229
+ ```
230
+ ~/.claude/achievements/state.json
231
+ ```
279
232
 
233
+ Reinicia tu viaje en cualquier momento:
280
234
  ```bash
281
235
  rm ~/.claude/achievements/state.json
282
236
  ```
283
237
 
284
- </details>
238
+ ---
285
239
 
286
- <details>
287
- <summary><b>Reinstalar el plugin</b></summary>
240
+ ## 🤝 Contribuir
288
241
 
289
- ```bash
290
- npx claude-code-achievements@latest
291
- ```
242
+ ¿Tienes una idea para un nuevo logro? ¿Encontraste un bug? ¡Las contribuciones son bienvenidas!
292
243
 
293
- </details>
244
+ - 🏆 Sugiere nuevos logros
245
+ - 🌍 Añade traducciones
246
+ - 🐛 Reporta problemas
247
+ - ⭐ ¡Dale una estrella al repo!
294
248
 
295
249
  ---
296
250
 
297
- ## Contribuir
298
-
299
- ¡Las contribuciones son bienvenidas! Ideas:
251
+ <div align="center">
300
252
 
301
- - Nuevos logros
302
- - Nuevas traducciones de idiomas
303
- - Mejoras de UI
304
- - Corrección de errores
253
+ ### ¿Listo para comenzar tu viaje?
305
254
 
306
- ## Licencia
255
+ ```bash
256
+ npx claude-code-achievements
257
+ ```
307
258
 
308
- MIT © [subinium](https://github.com/subinium)
259
+ **¡Sube de nivel. Desbloquea logros. Diviértete programando!**
309
260
 
310
261
  ---
311
262
 
312
- <div align="center">
313
-
314
- **¡Feliz programación!**
263
+ MIT © [subinium](https://github.com/subinium)
315
264
 
316
265
  </div>