@k2works/claude-code-booster 0.8.0 → 0.9.1

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 (71) hide show
  1. package/lib/assets/.claude/README.md +54 -136
  2. package/lib/assets/.claude/assets/.gitkeep +0 -0
  3. package/lib/assets/.claude/commands/git-commit.md +47 -0
  4. package/lib/assets/.claude/commands/ops.md +16 -16
  5. package/lib/assets/.claude/scripts/.gitkeep +0 -0
  6. package/lib/assets/README.md +77 -3
  7. package/lib/assets/apps/.gitkeep +0 -0
  8. package/package.json +1 -1
  9. package/lib/assets/.claude/agents/roles/analyzer.md +0 -267
  10. package/lib/assets/.claude/agents/roles/architect.md +0 -233
  11. package/lib/assets/.claude/agents/roles/backend.md +0 -303
  12. package/lib/assets/.claude/agents/roles/frontend.md +0 -294
  13. package/lib/assets/.claude/agents/roles/mobile.md +0 -309
  14. package/lib/assets/.claude/agents/roles/performance.md +0 -254
  15. package/lib/assets/.claude/agents/roles/qa.md +0 -266
  16. package/lib/assets/.claude/agents/roles/reviewer.md +0 -252
  17. package/lib/assets/.claude/agents/roles/security.md +0 -392
  18. package/lib/assets/.claude/assets/confirm.mp3 +0 -0
  19. package/lib/assets/.claude/assets/perfect.mp3 +0 -0
  20. package/lib/assets/.claude/assets/silent.wav +0 -0
  21. package/lib/assets/.claude/commands/analyze-dependencies.md +0 -158
  22. package/lib/assets/.claude/commands/analyze-performance.md +0 -116
  23. package/lib/assets/.claude/commands/check-fact.md +0 -104
  24. package/lib/assets/.claude/commands/check-github-ci.md +0 -53
  25. package/lib/assets/.claude/commands/check-prompt.md +0 -461
  26. package/lib/assets/.claude/commands/commit-message.md +0 -348
  27. package/lib/assets/.claude/commands/context7.md +0 -50
  28. package/lib/assets/.claude/commands/design-patterns.md +0 -186
  29. package/lib/assets/.claude/commands/explain-code.md +0 -75
  30. package/lib/assets/.claude/commands/fix-error.md +0 -258
  31. package/lib/assets/.claude/commands/multi-role.md +0 -291
  32. package/lib/assets/.claude/commands/next.md +0 -136
  33. package/lib/assets/.claude/commands/pr-auto-update.md +0 -460
  34. package/lib/assets/.claude/commands/pr-create.md +0 -249
  35. package/lib/assets/.claude/commands/pr-feedback.md +0 -143
  36. package/lib/assets/.claude/commands/pr-issue.md +0 -78
  37. package/lib/assets/.claude/commands/pr-list.md +0 -66
  38. package/lib/assets/.claude/commands/pr-review.md +0 -142
  39. package/lib/assets/.claude/commands/refactor.md +0 -147
  40. package/lib/assets/.claude/commands/role-debate.md +0 -571
  41. package/lib/assets/.claude/commands/role-help.md +0 -276
  42. package/lib/assets/.claude/commands/role.md +0 -360
  43. package/lib/assets/.claude/commands/screenshot.md +0 -103
  44. package/lib/assets/.claude/commands/search-gemini.md +0 -66
  45. package/lib/assets/.claude/commands/semantic-commit.md +0 -1129
  46. package/lib/assets/.claude/commands/sequential-thinking.md +0 -90
  47. package/lib/assets/.claude/commands/show-plan.md +0 -59
  48. package/lib/assets/.claude/commands/smart-review.md +0 -174
  49. package/lib/assets/.claude/commands/spec.md +0 -559
  50. package/lib/assets/.claude/commands/style-ai-writing.md +0 -186
  51. package/lib/assets/.claude/commands/task.md +0 -223
  52. package/lib/assets/.claude/commands/tech-debt.md +0 -87
  53. package/lib/assets/.claude/commands/ultrathink.md +0 -65
  54. package/lib/assets/.claude/commands/update-dart-doc.md +0 -202
  55. package/lib/assets/.claude/commands/update-doc-string.md +0 -306
  56. package/lib/assets/.claude/commands/update-flutter-deps.md +0 -105
  57. package/lib/assets/.claude/commands/update-node-deps.md +0 -105
  58. package/lib/assets/.claude/commands/update-rust-deps.md +0 -107
  59. package/lib/assets/.claude/scripts/auto-comment.sh +0 -16
  60. package/lib/assets/.claude/scripts/check-ai-commit.sh +0 -20
  61. package/lib/assets/.claude/scripts/check-continue.sh +0 -97
  62. package/lib/assets/.claude/scripts/check-locales.sh +0 -1080
  63. package/lib/assets/.claude/scripts/check-project-plan.sh +0 -25
  64. package/lib/assets/.claude/scripts/debug-hook.sh +0 -7
  65. package/lib/assets/.claude/scripts/deny-check.sh +0 -69
  66. package/lib/assets/.claude/scripts/install.sh +0 -174
  67. package/lib/assets/.claude/scripts/ja-space-exclusions.json +0 -18
  68. package/lib/assets/.claude/scripts/ja-space-format.sh +0 -45
  69. package/lib/assets/.claude/scripts/preserve-file-permissions.sh +0 -83
  70. package/lib/assets/.claude/scripts/statusline.sh +0 -153
  71. /package/lib/assets/{app → .claude/agents/roles}/.gitkeep +0 -0
@@ -1,276 +0,0 @@
1
- ## Role Help
2
-
3
- どのロールを使うべきか迷った時の選択ガイドとヘルプシステム。
4
-
5
- ### 使い方
6
-
7
- ```bash
8
- /role-help # 全般的なロール選択ガイド
9
- /role-help <状況/問題> # 特定状況での推奨ロール
10
- /role-help compare <ロール 1>,<ロール 2> # ロール比較
11
- ```
12
-
13
- ### 基本例
14
-
15
- ```bash
16
- # 一般的なガイダンス
17
- /role-help
18
- → 利用可能なロールと特徴の一覧表示
19
-
20
- # 状況別の推奨
21
- /role-help "API のセキュリティが心配"
22
- → security ロールの推奨と使用方法
23
-
24
- # ロール比較
25
- /role-help compare frontend,mobile
26
- → frontend と mobile の違いと使い分け
27
- ```
28
-
29
- ### 状況別ロール選択ガイド
30
-
31
- ### セキュリティ関連
32
-
33
- ```
34
- こんな時は security ロール:
35
- ✅ ログイン・認証機能の実装
36
- ✅ API のセキュリティ脆弱性チェック
37
- ✅ データ暗号化・プライバシー保護
38
- ✅ セキュリティコンプライアンス確認
39
- ✅ 侵入テスト・ペネトレーションテスト
40
-
41
- 使い方: /role security
42
- ```
43
-
44
- ### 🏗️ アーキテクチャ・設計
45
-
46
- ```
47
- こんな時は architect ロール:
48
- ✅ システム全体の設計評価
49
- ✅ マイクロサービス vs モノリス判断
50
- ✅ データベース設計・技術選定
51
- ✅ スケーラビリティ・拡張性の検討
52
- ✅ 技術的負債の評価・改善計画
53
-
54
- 使い方: /role architect
55
- ```
56
-
57
- ### ⚡ パフォーマンス問題
58
-
59
- ```
60
- こんな時は performance ロール:
61
- ✅ アプリケーションが遅い
62
- ✅ データベースクエリの最適化
63
- ✅ Web ページの読み込み速度改善
64
- ✅ メモリ・ CPU 使用量の最適化
65
- ✅ スケーリング・負荷対策
66
-
67
- 使い方: /role performance
68
- ```
69
-
70
- ### 🔍 問題の原因調査
71
-
72
- ```
73
- こんな時は analyzer ロール:
74
- ✅ バグ・エラーの根本原因分析
75
- ✅ システム障害の原因究明
76
- ✅ 複雑な問題の構造的分析
77
- ✅ データ分析・統計的調査
78
- ✅ なぜこの問題が起きたかの解明
79
-
80
- 使い方: /role analyzer
81
- ```
82
-
83
- ### 🎨 フロントエンド・ UI/UX
84
-
85
- ```
86
- こんな時は frontend ロール:
87
- ✅ ユーザーインターフェースの改善
88
- ✅ アクセシビリティ対応
89
- ✅ レスポンシブデザイン
90
- ✅ ユーザビリティ・使いやすさ向上
91
- ✅ Web フロントエンド技術全般
92
-
93
- 使い方: /role frontend
94
- ```
95
-
96
- ### 📱 モバイルアプリ開発
97
-
98
- ```
99
- こんな時は mobile ロール:
100
- ✅ iOS ・ Android アプリの最適化
101
- ✅ モバイル特有の UX 設計
102
- ✅ タッチインターフェース最適化
103
- ✅ オフライン対応・同期機能
104
- ✅ App Store ・ Google Play 対応
105
-
106
- 使い方: /role mobile
107
- ```
108
-
109
- ### 👀 コードレビュー・品質
110
-
111
- ```
112
- こんな時は reviewer ロール:
113
- ✅ コードの品質チェック
114
- ✅ 可読性・保守性の評価
115
- ✅ コーディング規約の確認
116
- ✅ リファクタリング提案
117
- ✅ PR ・コミットのレビュー
118
-
119
- 使い方: /role reviewer
120
- ```
121
-
122
- ### 🧪 テスト・品質保証
123
-
124
- ```
125
- こんな時は qa ロール:
126
- ✅ テスト戦略の立案
127
- ✅ テストカバレッジの評価
128
- ✅ 自動テストの実装方針
129
- ✅ バグ防止・品質向上策
130
- ✅ CI/CD でのテスト自動化
131
-
132
- 使い方: /role qa
133
- ```
134
-
135
- ### 複数ロールが必要な場合
136
-
137
- ### 🔄 multi-role (並行分析)
138
-
139
- ```
140
- こんな時は multi-role:
141
- ✅ 複数の専門視点での評価が欲しい
142
- ✅ 統合的な改善計画を立てたい
143
- ✅ 各分野の評価を比較したい
144
- ✅ 矛盾・重複を整理したい
145
-
146
- 例: /multi-role security,performance
147
- ```
148
-
149
- ### 🗣️ role-debate (議論)
150
-
151
- ```
152
- こんな時は role-debate:
153
- ✅ 専門分野間でトレードオフがある
154
- ✅ 技術選定で意見が分かれる
155
- ✅ 設計方針を議論で決めたい
156
- ✅ 異なる視点の議論を聞きたい
157
-
158
- 例: /role-debate security,performance
159
- ```
160
-
161
- ### 🤖 smart-review (自動提案)
162
-
163
- ```
164
- こんな時は smart-review:
165
- ✅ どのロールを使うべきか分からない
166
- ✅ 現在の状況に最適なアプローチを知りたい
167
- ✅ 複数の選択肢から選びたい
168
- ✅ 初心者で判断に迷う
169
-
170
- 例: /smart-review
171
- ```
172
-
173
- ### ロール比較表
174
-
175
- ### セキュリティ系
176
-
177
- | ロール | 主な用途 | 得意分野 | 苦手分野 |
178
- |--------|----------|----------|----------|
179
- | security | 脆弱性・攻撃対策 | 脅威分析、認証設計 | UX、パフォーマンス |
180
- | analyzer | 根本原因分析 | 論理的分析、証拠収集 | 予防策、将来計画 |
181
-
182
- ### 設計系
183
-
184
- | ロール | 主な用途 | 得意分野 | 苦手分野 |
185
- |--------|----------|----------|----------|
186
- | architect | システム設計 | 長期視点、全体最適 | 詳細実装、短期解決 |
187
- | reviewer | コード品質 | 実装レベル、保守性 | ビジネス要件、UX |
188
-
189
- ### パフォーマンス系
190
-
191
- | ロール | 主な用途 | 得意分野 | 苦手分野 |
192
- |--------|----------|----------|----------|
193
- | performance | 高速化・最適化 | 測定、ボトルネック | セキュリティ、UX |
194
- | qa | 品質保証 | テスト、自動化 | 設計、アーキテクチャ |
195
-
196
- ### ユーザー体験系
197
-
198
- | ロール | 主な用途 | 得意分野 | 苦手分野 |
199
- |--------|----------|----------|----------|
200
- | frontend | Web UI/UX | ブラウザ、アクセシビリティ | サーバーサイド、DB |
201
- | mobile | モバイル UX | タッチ、オフライン対応 | サーバーサイド、Web |
202
-
203
- ### 迷った時のフローチャート
204
-
205
- ```
206
- 問題の性質は?
207
- ├─ セキュリティ関連 → security
208
- ├─ パフォーマンス問題 → performance
209
- ├─ バグ・障害調査 → analyzer
210
- ├─ UI/UX 改善 → frontend or mobile
211
- ├─ 設計・アーキテクチャ → architect
212
- ├─ コード品質 → reviewer
213
- ├─ テスト関連 → qa
214
- └─ 複合的・複雑 → smart-review で提案
215
-
216
- 複数の分野にまたがる?
217
- ├─ 統合分析したい → multi-role
218
- ├─ 議論・トレードオフ → role-debate
219
- └─ 判断に迷う → smart-review
220
- ```
221
-
222
- ### よくある質問
223
-
224
- ### Q: frontend と mobile の違いは?
225
-
226
- ```
227
- A:
228
- frontend: Web ブラウザ中心、HTML/CSS/JavaScript
229
- mobile: モバイルアプリ中心、iOS/Android ネイティブ・ React Native など
230
-
231
- 両方関連する場合は multi-role frontend,mobile がおすすめ
232
- ```
233
-
234
- ### Q: security と analyzer の使い分けは?
235
-
236
- ```
237
- A:
238
- security: 攻撃・脅威の予防、セキュリティ設計
239
- analyzer: 既に起きた問題の原因分析、調査
240
-
241
- セキュリティインシデントの調査なら multi-role security,analyzer
242
- ```
243
-
244
- ### Q: architect と performance の違いは?
245
-
246
- ```
247
- A:
248
- architect: システム全体の長期的設計、拡張性
249
- performance: 具体的な速度・効率の改善
250
-
251
- 大規模システムの性能設計なら multi-role architect,performance
252
- ```
253
-
254
- ### Claude との連携
255
-
256
- ```bash
257
- # 状況説明と組み合わせ
258
- /role-help
259
- 「React アプリのページ読み込みが遅くて、ユーザーから苦情が来ている」
260
-
261
- # ファイル内容と組み合わせ
262
- cat problem-description.md
263
- /role-help
264
- 「この問題に最適なロールを推奨して」
265
-
266
- # 特定の選択肢で迷っている場合
267
- /role-help compare security,performance
268
- 「JWT トークンの有効期限問題でどちらのロールが適切?」
269
- ```
270
-
271
- ### 注意事項
272
-
273
- - 複雑な問題ほど複数ロールの組み合わせが効果的です
274
- - 緊急性が高い場合は single role で迅速に対応
275
- - 迷った時は smart-review で自動提案を受けることをおすすめします
276
- - 最終的な判断はユーザーが問題の性質を考慮して決定してください
@@ -1,360 +0,0 @@
1
- ## Role
2
-
3
- 特定のロール(役割)に切り替えて、専門的な分析や作業を実行します。
4
-
5
- ### 使い方
6
-
7
- ```bash
8
- /role <ロール名> [--agent|-a]
9
- ```
10
-
11
- ### オプション
12
-
13
- - `--agent` または `-a` : サブエージェントとして独立実行(大規模分析時推奨)
14
- - このオプションを使用すると、ロールの description に自動委任促進フレーズ("use PROACTIVELY" など)が含まれている場合、より積極的な自動委任が有効になります
15
-
16
- ### 利用可能なロール
17
-
18
- #### 専門分析ロール(Evidence-First 統合)
19
-
20
- - `security` : セキュリティ監査専門家(OWASP Top 10 ・脅威モデリング・ Zero Trust 原則・ CVE 照合)
21
- - `performance` : パフォーマンス最適化専門家(Core Web Vitals ・ RAIL モデル・段階的最適化・ ROI 分析)
22
- - `analyzer` : 根本原因分析専門家(5 Whys ・システム思考・仮説駆動・認知バイアス対策)
23
- - `frontend` : フロントエンド・ UI/UX 専門家(WCAG 2.1 ・デザインシステム・ユーザー中心設計)
24
-
25
- #### 開発支援ロール
26
-
27
- - `reviewer` : コードレビュー専門家(可読性・保守性・パフォーマンス・リファクタリング提案)
28
- - `architect` : システムアーキテクト(Evidence-First 設計・ MECE 分析・進化的アーキテクチャ)
29
- - `qa` : テストエンジニア(テストカバレッジ・ E2E/統合/単体戦略・自動化提案)
30
- - `mobile` : モバイル開発専門家(iOS HIG ・ Android Material Design ・クロスプラットフォーム戦略)
31
-
32
- ### 基本例
33
-
34
- ```bash
35
- # セキュリティ監査モードに切り替え(通常)
36
- /role security
37
- 「このプロジェクトのセキュリティ脆弱性をチェックして」
38
-
39
- # セキュリティ監査をサブエージェントで実行(大規模分析)
40
- /role security --agent
41
- 「プロジェクト全体のセキュリティ監査を実行して」
42
-
43
- # コードレビューモードに切り替え
44
- /role reviewer
45
- 「最近の変更をレビューして改善点を指摘して」
46
-
47
- # パフォーマンス最適化モードに切り替え
48
- /role performance
49
- 「アプリケーションのボトルネックを分析して」
50
-
51
- # 根本原因分析モードに切り替え
52
- /role analyzer
53
- 「この障害の根本原因を調査して」
54
-
55
- # フロントエンド専門モードに切り替え
56
- /role frontend
57
- 「UI/UX の改善点を評価して」
58
-
59
- # モバイル開発専門モードに切り替え
60
- /role mobile
61
- 「このアプリのモバイル最適化を評価して」
62
-
63
- # 通常モードに戻る
64
- /role default
65
- 「通常の Claude に戻ります」
66
- ```
67
-
68
- ### Claude との連携
69
-
70
- ```bash
71
- # セキュリティ特化の分析
72
- /role security
73
- cat app.js
74
- 「このコードの潜在的なセキュリティリスクを詳細に分析して」
75
-
76
- # アーキテクチャ観点での評価
77
- /role architect
78
- ls -la src/
79
- 「現在の構造の問題点と改善案を提示して」
80
-
81
- # テスト戦略の立案
82
- /role qa
83
- 「このプロジェクトに最適なテスト戦略を提案して」
84
- ```
85
-
86
- ### 詳細例
87
-
88
- ```bash
89
- # 複数ロールでの分析
90
- /role security
91
- 「まずセキュリティ観点でチェック」
92
- git diff HEAD~1
93
-
94
- /role reviewer
95
- 「次に一般的なコード品質をレビュー」
96
-
97
- /role architect
98
- 「最後にアーキテクチャの観点から評価」
99
-
100
- # ロール固有の出力形式
101
- /role security
102
- セキュリティ分析結果
103
- ━━━━━━━━━━━━━━━━━━━━━
104
- 脆弱性: SQL インジェクション
105
- 深刻度: High
106
- 該当箇所: db.js:42
107
- 修正案: パラメータ化クエリを使用
108
- ```
109
-
110
- ### Evidence-First 統合機能
111
-
112
- #### 核心理念
113
-
114
- 各ロールは **Evidence-First(根拠ベース)** アプローチを採用し、推測ではなく **実証済みの手法・公式ガイドライン・客観的データ** に基づいて分析・提案を行います。
115
-
116
- #### 共通特徴
117
-
118
- - **公式ドキュメント準拠**: 各分野の権威ある公式ガイドラインを優先参照
119
- - **MECE 分析**: 漏れなく重複なく体系的な問題分解
120
- - **多角的評価**: 技術・ビジネス・運用・ユーザーの複数視点
121
- - **認知バイアス対策**: 確証バイアス等の排除メカニズム
122
- - **議論特性**: ロール固有の専門的議論スタンス
123
-
124
- ### 専門分析ロールの詳細
125
-
126
- #### security(セキュリティ監査専門家)
127
-
128
- **Evidence-Based セキュリティ監査**
129
-
130
- - OWASP Top 10 ・ Testing Guide ・ SAMM による体系的評価
131
- - CVE ・ NVD データベース照合による既知脆弱性チェック
132
- - STRIDE ・ Attack Tree ・ PASTA による脅威モデリング
133
- - Zero Trust 原則・最小権限による設計評価
134
-
135
- **専門的報告形式**
136
-
137
- ```
138
- Evidence-Based セキュリティ監査結果
139
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
140
- OWASP Top 10 準拠度: XX% / CVE 照合: 完了
141
- 脅威モデリング: STRIDE 分析済み
142
- ```
143
-
144
- #### performance(パフォーマンス最適化専門家)
145
-
146
- **Evidence-First パフォーマンス最適化**
147
-
148
- - Core Web Vitals(LCP ・ FID ・ CLS)・ RAIL モデル準拠
149
- - Google PageSpeed Insights 推奨事項の実装
150
- - 段階的最適化プロセス(測定→分析→優先順位→実装)
151
- - ROI 分析による投資対効果の定量評価
152
-
153
- **専門的報告形式**
154
-
155
- ```
156
- Evidence-First パフォーマンス分析
157
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
158
- Core Web Vitals: LCP[XXXms] FID[XXXms] CLS[X.XX]
159
- Performance Budget: XX% / ROI 分析: XX% 改善予測
160
- ```
161
-
162
- #### analyzer(根本原因分析専門家)
163
-
164
- **Evidence-First 根本原因分析**
165
-
166
- - 5 Whys + α手法(反証検討含む)
167
- - システム思考による構造分析(Peter Senge 原則)
168
- - 認知バイアス対策(確証バイアス・アンカリング等の排除)
169
- - 仮説駆動分析の徹底(複数仮説の並行検証)
170
-
171
- **専門的報告形式**
172
-
173
- ```
174
- Evidence-First 根本原因分析
175
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
176
- 分析信頼度: 高 / バイアス対策: 実施済み
177
- 仮説検証マトリックス: XX% 確信度
178
- ```
179
-
180
- #### frontend(フロントエンド・ UI/UX 専門家)
181
-
182
- **Evidence-First フロントエンド開発**
183
-
184
- - WCAG 2.1 アクセシビリティ準拠
185
- - Material Design ・ iOS HIG 公式ガイドライン準拠
186
- - ユーザー中心設計・デザインシステム標準適用
187
- - A/B テスト・ユーザー行動分析による検証
188
-
189
- ### 開発支援ロールの詳細
190
-
191
- #### reviewer(コードレビュー専門家)
192
-
193
- - 可読性・保守性・パフォーマンスの多角的評価
194
- - コーディング規約遵守チェック・リファクタリング提案
195
- - セキュリティ・アクセシビリティの横断的確認
196
-
197
- #### architect(システムアーキテクト)
198
-
199
- - Evidence-First 設計原則・ MECE 分析による段階的思考
200
- - 進化的アーキテクチャ・複数視点評価(技術・ビジネス・運用・ユーザー)
201
- - 公式アーキテクチャパターン・ベストプラクティス参照
202
-
203
- #### qa(テストエンジニア)
204
-
205
- - テストカバレッジ分析・ E2E/統合/単体テスト戦略
206
- - テスト自動化提案・品質メトリクス設計
207
-
208
- #### mobile(モバイル開発専門家)
209
-
210
- - iOS HIG ・ Android Material Design 公式ガイドライン準拠
211
- - クロスプラットフォーム戦略・ Touch-First 設計
212
- - ストア審査ガイドライン・モバイル特化 UX 最適化
213
-
214
- ### ロール固有の議論特性
215
-
216
- 各ロールは専門分野に応じた独自の議論スタンス・論拠ソース・強みを持ちます。
217
-
218
- #### security ロールの議論特性
219
-
220
- - **スタンス**: 保守的アプローチ・リスク最小化優先・最悪ケース想定
221
- - **論拠**: OWASP ガイドライン・ NIST フレームワーク・実際の攻撃事例
222
- - **強み**: リスク評価の精度・規制要件の深い知識・攻撃手法の包括的理解
223
- - **注意**: 過度な保守性・ UX への配慮不足・実装コストの軽視
224
-
225
- #### performance ロールの議論特性
226
-
227
- - **スタンス**: データ駆動判断・効率性重視・ユーザー体験優先・継続的改善
228
- - **論拠**: Core Web Vitals ・ベンチマーク結果・ユーザー行動データ・業界標準
229
- - **強み**: 定量的評価能力・ボトルネック特定の精度・ ROI 分析
230
- - **注意**: セキュリティの軽視・保守性への配慮不足・計測偏重
231
-
232
- #### analyzer ロールの議論特性
233
-
234
- - **スタンス**: 証拠重視・仮説検証・構造的思考・バイアス除去
235
- - **論拠**: 実測データ・統計的手法・システム思考理論・認知バイアス研究
236
- - **強み**: 論理的分析能力・証拠評価の客観性・構造的問題の発見力
237
- - **注意**: 分析麻痺・完璧主義・データ万能主義・過度な懐疑主義
238
-
239
- #### frontend ロールの議論特性
240
-
241
- - **スタンス**: ユーザー中心・アクセシビリティ重視・デザイン原則準拠・体験価値優先
242
- - **論拠**: UX 調査・アクセシビリティ標準・デザインシステム・ユーザビリティテスト
243
- - **強み**: ユーザー視点・デザイン原則・アクセシビリティ・体験設計
244
- - **注意**: 技術制約の軽視・パフォーマンスへの配慮不足・実装複雑性
245
-
246
- ### マルチロール協調の効果
247
-
248
- 異なる議論特性を持つロールの組み合わせにより、バランスの取れた分析が可能:
249
-
250
- #### 典型的な協調パターン
251
-
252
- - **security + frontend**: セキュリティとユーザビリティのバランス
253
- - **performance + security**: 速度と安全性の両立
254
- - **analyzer + architect**: 問題分析と構造設計の統合
255
- - **reviewer + qa**: コード品質とテスト戦略の連携
256
-
257
- ## 高度なロール機能
258
-
259
- ### インテリジェントロール選択
260
-
261
- - `/smart-review` : プロジェクト分析による自動ロール提案
262
- - `/role-help` : 状況に応じた最適ロール選択ガイド
263
-
264
- ### マルチロール協調
265
-
266
- - `/multi-role <ロール 1>,<ロール 2>` : 複数ロール同時分析
267
- - `/role-debate <ロール 1>,<ロール 2>` : ロール間議論
268
-
269
- ### 使用例
270
-
271
- #### 自動ロール提案
272
-
273
- ```bash
274
- /smart-review
275
- → 現在の状況を分析して最適なロールを提案
276
-
277
- /smart-review src/auth/
278
- → 認証関連ファイルから security ロールを推奨
279
- ```
280
-
281
- #### 複数ロール分析
282
-
283
- ```bash
284
- /multi-role security,performance
285
- 「この API を複数の視点で評価して」
286
- → セキュリティとパフォーマンスの両面から統合分析
287
-
288
- /role-debate frontend,security
289
- 「2 段階認証の UX について議論して」
290
- → ユーザビリティとセキュリティの観点で議論
291
- ```
292
-
293
- #### ロール選択に迷った場合
294
-
295
- ```bash
296
- /role-help "API が遅くてセキュリティも心配"
297
- → 適切なアプローチ(multi-role や debate)を提案
298
-
299
- /role-help compare frontend,mobile
300
- → フロントエンドとモバイルロールの違いと使い分け
301
- ```
302
-
303
- ## 注意事項
304
-
305
- ### ロール動作について
306
-
307
- - ロールを切り替えると、Claude の **振る舞い・優先事項・分析手法・報告形式** が専門特化します
308
- - 各ロールは **Evidence-First アプローチ** で公式ガイドライン・実証済み手法を優先適用
309
- - `default` で通常モードに戻ります(ロール特化が解除されます)
310
- - ロールは現在のセッション内でのみ有効です
311
-
312
- ### 効果的な活用方法
313
-
314
- - **単純な問題**: 単一ロールで十分な専門分析
315
- - **複雑な問題**: multi-role や role-debate で多角的分析が効果的
316
- - **迷った時**: smart-review や role-help をご利用ください
317
- - **継続的改善**: 同じロールでも新たな証拠・手法で分析精度が向上
318
-
319
- ### サブエージェント機能(--agent オプション)
320
-
321
- 大規模な分析や独立した専門的処理が必要な場合、`--agent` オプションを使用してロールをサブエージェントとして実行できます。
322
-
323
- #### メリット
324
-
325
- - **独立コンテキスト**: メインの会話を妨げない
326
- - **並列実行**: 複数の分析を同時実行可能
327
- - **専門特化**: より深い分析と詳細なレポート
328
- - **自動委任の促進**: ロールの description に "use PROACTIVELY" や "MUST BE USED" が含まれている場合、より積極的な自動委任が有効化
329
-
330
- #### 推奨される使用場面
331
-
332
- ```bash
333
- # セキュリティ: OWASP 全項目チェック、CVE 照合
334
- /role security --agent
335
- 「全コードベースのセキュリティ監査」
336
-
337
- # アナライザー: 大量ログの根本原因分析
338
- /role analyzer --agent
339
- 「過去 1 週間のエラーログを分析」
340
-
341
- # レビュアー: 大規模 PR の詳細レビュー
342
- /role reviewer --agent
343
- 「PR #500 の 1000 行の変更をレビュー」
344
- ```
345
-
346
- #### 通常ロール vs サブエージェント
347
-
348
- | 状況 | 推奨 | コマンド |
349
- |------|------|----------|
350
- | 簡単な確認 | 通常ロール | `/role security` |
351
- | 大規模分析 | サブエージェント | `/role security --agent` |
352
- | 対話的作業 | 通常ロール | `/role frontend` |
353
- | 独立した監査 | サブエージェント | `/role qa --agent` |
354
-
355
- ### ロール設定の詳細
356
-
357
- - 各ロールの詳細設定・專門知識・議論特性は `.claude/agents/roles/` ディレクトリ内で定義
358
- - Evidence-First 手法・認知バイアス対策も含む
359
- - ロール固有のトリガーフレーズで自動的に特化モードが有効化
360
- - 実際のロールファイルは 200 行超の専門的内容で構成