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.ja.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
- **Steam スタイルの 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.ko.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. 言語設定を確認
40
- 3. 通知スタイルを設定(システム/ターミナル/両方)
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` を 2 回) |
92
- | 🗣️ **コミュニケーター** | Claude が `AskUserQuestion` で要件を確認 |
93
- | 🌍 **グローバルキュレーター** | `~/.claude/CLAUDE.md` を設定 |
94
- | 📦 **バージョン管理者** | Claude と一緒にコミット |
95
- | 🚀 **シップイット!** | リモートリポジトリにプッシュ |
96
- | 🧪 **品質ガーディアン** | Claude と一緒にテストを実行 |
97
- | 🚦 **CI/CD パイオニア** | GitHub Actions ワークフローを作成 |
98
-
99
- </details>
100
-
101
- <details>
102
- <summary><b>パワーツール</b>(9 アチーブメント)</summary>
103
-
104
- | アチーブメント | 解除方法 |
105
- |----------------|----------|
106
- | 🎨 **ビジュアルインスペクター** | 画像やスクリーンショットを分析 |
107
- | 📡 **ドキュメントハンター** | Web ページを取得して分析 |
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 2 つのフックを登録します:
108
+ | | 実績 | クエスト |
109
+ |:--:|------|----------|
110
+ | 📋 | **タスクプランナー** | TodoWrite でタスク管理 |
111
+ | 🎯 | **戦略的思考者** | プランモードに入る (`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
+ | 📡 | **ドキュメントハンター** | Web ページを取得して分析 |
129
+ | 🤖 | **デリゲーションマスター** | Task でサブエージェントを生成 |
130
+ | 🔌 | **MCP パイオニア** | MCP ツールを使用 |
131
+ | 🌐 | **ウェブエクスプローラー** | Web 検索 |
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": "ja",
243
- "notifications": true,
244
- "notification_style": "system"
245
- },
246
- "achievements": {},
247
- "counters": {}
248
- }
186
+ ## 🛠️ 仕組み
187
+
188
+ ```
189
+ あなた: "設定ファイルを編集して"
190
+
191
+
192
+ ┌─────────────────────┐
193
+ Claude が Edit 使用 │
194
+ └─────────────────────┘
195
+
196
+
197
+ ┌─────────────────────┐
198
+ │ 🎯 フック発動 │──▶ 実績チェック
199
+ └─────────────────────┘
200
+
201
+ ┌──────┴──────┐
202
+ ▼ ▼
203
+ ┌───────┐ ┌────────┐
204
+ │ 🏆 +1 │ │ なし │
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>