dart-log-failure-parser について
Dartログを調べ、テスト、解析、ビルドなどの具体的な失敗原因を特定するワークフロースキルです。ログ全体を確認し、失敗したコマンドだけでなく詳細を報告するようエージェントに指示します。
主な機能
- 01ログ全体の確認
- 02構造化されたエラーブロックとタスクJSONの検索
- 03失敗したテストの特定
- 04コンパイラー、リンカー、ビルドエラーの検出
活用シーン
- 01失敗したDartテスト実行の分析
- 02ビルドログから具体的なエラーを特定
- 03タスク出力のエラー要約
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ flutter/ flutter --skill dart-log-failure-parserインストール後、Claude Code で/dart-log-failure-parserを入力して読み込まれたか確認します。
詳細
Dart ログ障害パーサー
ワークフロー
1. 生ログ出力を分析する
障害の詳細を把握するため、生ログ出力を分析します。出力を流し読みせず、ログ全体を確認してください。調査結果の説明には、失敗した最上位のコマンドだけでなく、失敗に関する具体的な詳細(例:フォーマットされていないファイル、具体的なテスト名)を含めてください。
2. 障害パターンを探す
パターン A:エラーブロック(例:Linux Analyze)
╡ERROR # で始まるブロックを探します。
例:
╔═╡ERROR #1╞════════════════════════════════════════════════════════════════════
║ Command: bin/cache/dart-sdk/bin/dart --enable-asserts /b/s/w/ir/x/w/flutter/dev/bots/analyze_snippet_code.dart --verbose
║ Command exited with exit code 255 but expected zero exit code.
║ Working directory: /b/s/w/ir/x/w/flutter
╚═══════════════════════════════════════════════════════════════════════════════
パターン B:タスク結果の JSON
「Task result:」に続く JSON オブジェクトを探します。 例:
Task result:
{
"success": false,
"reason": "Task failed: PathNotFoundException: Cannot open file..."
}
パターン C:失敗したテストの一覧
一般的な Dart テストでは、ログの末尾に「Failing tests:」で始まる一覧がないか確認します。 例:
Failing tests:
test/general.shard/cache_test.dart: FontSubset artifacts for all platforms on arm64 hosts
test/general.shard/cache_test.dart: FontSubset artifacts on arm64 linux
パターン D:ビルドの失敗
ビルドの失敗(例:コンパイル時に失敗するエンジンテスト)では、ログまたは API の概要から次の指標を探します。
FAILED:で始まる行(Ninja のターゲットが失敗したことを示します)。- コンパイラーのエラーメッセージ(例:
error:、fatal error:)。 - リンカーのエラーメッセージ(例:
undefined reference to)。 - check-runs API の出力にある概要メッセージ(例:
1 build failed: [<build_name>])。
コメント
Markdown 対応