# quarkus-error-solver

> Quarkusアプリケーションのエラーを分析し解決策を提供する。CDI/DI、データベース、REST/HTTP、Nativeビルド、Kotlin固有のエラーをカバー。Quarkusエラーのトラブルシューティング、デバッグ、ビルド問題の解決時に使用。io.quarkus、jakarta.*を含むスタックトレースが対象。

- Author: akaitigo
- Repository: akaitigo/claude-skills-quarkus
- Version: 20251221020920
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/akaitigo/claude-skills-quarkus
- Web: https://mule.run/skillshub/@@akaitigo/claude-skills-quarkus~quarkus-error-solver:20251221020920

---

---
name: quarkus-error-solver
description: |
  Quarkusアプリケーションのエラーを分析し解決策を提供する。CDI/DI、データベース、REST/HTTP、Nativeビルド、Kotlin固有のエラーをカバー。Quarkusエラーのトラブルシューティング、デバッグ、ビルド問題の解決時に使用。io.quarkus、jakarta.*を含むスタックトレースが対象。
license: MIT
---

# Quarkus Error Solver

Quarkus + Kotlin アプリケーションのエラーを診断・解決する。

## 自動検出

ターミナル出力でQuarkus関連エラー（ビルドログ、ランタイム例外）を検出した場合、ユーザーのリクエストを待たずに自動的にこのスキルを適用する。

**トリガーパターン:**
- `./gradlew build` または `./gradlew quarkusDev` からのスタックトレースを含むビルド失敗
- Quarkus dev モード中のランタイム例外
- Quarkus固有エラーを含むテスト失敗
- スタックトレースに含まれるキーワード: `jakarta.enterprise`, `io.quarkus`, `jakarta.persistence`, `jakarta.ws.rs`
- エラーキーワード: `UnsatisfiedResolutionException`, `AmbiguousResolutionException`, `TransactionRequiredException`, `PersistenceException`
- Kotlin固有: `not proxyable because it's final`, `lateinit property not initialized`, `Unresolved reference 'listAll'`

**例:** `UnsatisfiedResolutionException` でビルドが失敗した場合、即座にエラーを分析し ERROR_PATTERNS.md から解決策を提供する。

## クイックスタート

1. エラーメッセージまたはスタックトレースを貼り付ける
2. [ERROR_PATTERNS.md](references/ERROR_PATTERNS.md) からエラーパターンを特定
3. 解決策とコード修正を提供

## 対応エラーカテゴリ

| カテゴリ | 例 |
|----------|----------|
| CDI/DI | `UnsatisfiedResolutionException`, `AmbiguousResolutionException`, 循環依存 |
| データベース | 接続エラー, `EntityNotFoundException`, `TransactionRequiredException` |
| REST/HTTP | JSONシリアライズ, CORS, 404 Not Found |
| Nativeビルド | リフレクション問題, リソース不足 |
| Dev Services | Docker未起動, ポート競合 |
| Kotlin | `lateinit` 未初期化, `final` クラスのプロキシ問題 |

## 解決策のフォーマット

```
## エラー概要
[簡潔な説明]

## 原因
[このエラーが発生した理由]

## 解決策
[ステップバイステップの修正手順]

## コード例
[Before/After コード]
```

## よくある修正

**Bean が見つからない:**
```kotlin
// スコープアノテーションを追加
@ApplicationScoped
class MyService { }
```

**トランザクションが必要:**
```kotlin
@Transactional
fun save(entity: Entity) { entity.persist() }
```

**Kotlin の final クラス:**
```kotlin
// build.gradle.kts - all-open プラグインが自動的に処理
```

## トラブルシューティングコマンド

```bash
./gradlew quarkusInfo      # Quarkus バージョン確認
./gradlew dependencies     # 依存関係の競合確認
```

## 未知のエラー

**重要**: ERROR_PATTERNS.md にパターンが存在しない場合:

1. **正直に伝える**: 「このエラーパターンはナレッジベースに記載されていません」と伝える
2. **解決策を捏造しない**: 一般知識に基づいて解決策を作り出さない
3. **エラーを正確に共有**: ユーザーに正確なエラーメッセージを表示
4. **一般的なガイダンスを提供**:
   - Quarkus バージョン互換性を確認: `./gradlew quarkusInfo`
   - 最近のコード変更をレビュー
   - [Quarkus GitHub issues](https://github.com/quarkusio/quarkus/issues) で検索
   - [Quarkus Discussions](https://github.com/quarkusio/quarkus/discussions) を確認
5. **コンテキストを求める**: エラーが不明確な場合は追加情報をリクエスト

**未知のエラーへの応答例:**
```
このエラーパターンは ERROR_PATTERNS.md に記載されていません。

エラー内容: [エラーメッセージ]

一般的なデバッグ手順:
1. ./gradlew quarkusInfo でバージョンを確認
2. 最近のコード変更を確認
3. Quarkus GitHub issues で類似の問題を検索

追加情報があれば共有してください。
```

## 参照

- [ERROR_PATTERNS.md](references/ERROR_PATTERNS.md) - エラーパターンデータベース
- [Quarkus Kotlin ガイド](https://quarkus.io/guides/kotlin)