陌讯skills聚合平台

debugging and troubleshooting

📁 shunsukehayashi/miyabi-claude-plugins 📅 Jan 1, 1970
11
总安装量
0
周安装量
#28308
全站排名
安装命令
npx skills add https://github.com/shunsukehayashi/miyabi-claude-plugins --skill Debugging and Troubleshooting

Skill 文档

🐛 Debugging and Troubleshooting

Version: 2.0.0 Last Updated: 2025-11-22 Priority: ⭐⭐⭐⭐ (P1 Level) Purpose: 体系的なエラー診断とRustデバッグワークフロー

📋 概要

コンパイルエラー、テスト失敗、ランタイムエラーに対する 体系的な診断と解決ワークフローを提供します。

🎯 P0: 呼び出しトリガー

トリガー 例
動作不良 “this code isn’t working”
テスト失敗 “why is this test failing?”
エラー解析 “debug this error”
コンパイルエラー “compilation error”
ランタイムエラー “runtime panic”

🔧 P1: エラー分類と対処

エラー分類表

分類 症状 診断コマンド 優先度
コンパイルエラー error[E####] cargo check 高
テスト失敗 test ... FAILED cargo test -- --nocapture 高
ランタイムpanic thread 'main' panicked RUST_BACKTRACE=1 高
ロジックエラー 期待と異なる出力 dbg!(), ログ 中
パフォーマンス 遅い・メモリ大 cargo bench, valgrind 中
統合エラー 外部サービス失敗 ネットワーク診断 低

🚀 P2: デバッグパターン

Pattern 1: コンパイルエラー

# Step 1: エラー確認
cargo check 2>&1 | head -50

# Step 2: エラーコード解析
# error[E0277] → Trait未実装
# error[E0412] → 型未定義
# error[E0433] → モジュール未解決

# Step 3: 詳細情報
rustc --explain E0277

よくあるエラーと解決:

エラーコード 原因 解決策
E0277 Trait未実装 #[derive(...)] または手動実装
E0412 型が見つからない use文追加
E0433 モジュール解決失敗 パス確認、mod宣言
E0502 借用競合 借用スコープ見直し
E0382 所有権移動後使用 clone() または参照

Pattern 2: テスト失敗

# Step 1: 失敗テスト特定
cargo test 2>&1 | grep FAILED

# Step 2: 詳細出力で実行
cargo test test_name -- --nocapture

# Step 3: 順次実行（並列問題回避）
cargo test -- --test-threads=1

# Step 4: アサーション詳細
# pretty_assertions, insta使用推奨

Pattern 3: ランタイムpanic

# Step 1: バックトレース取得
RUST_BACKTRACE=1 cargo run

# Step 2: 完全バックトレース
RUST_BACKTRACE=full cargo run

# Step 3: panic箇所特定
# at src/lib.rs:42:5 を確認

# Step 4: デバッガ使用
rust-lldb target/debug/miyabi

Pattern 4: ロジックエラー

// dbg!マクロ使用
let result = dbg!(compute_value());

// tracing使用
tracing::debug!(?value, "computed value");

// 条件付きログ
if cfg!(debug_assertions) {
    println!("Debug: {:?}", state);
}

⚡ P3: 高度なデバッグツール

デバッグツール一覧

ツール 用途 コマンド
rust-lldb デバッガ rust-lldb target/debug/miyabi
cargo-expand マクロ展開 cargo expand
cargo-asm アセンブリ確認 cargo asm
valgrind メモリ診断 valgrind ./target/debug/miyabi
miri UB検出 cargo +nightly miri test

VS Codeデバッグ設定

{
  "type": "lldb",
  "request": "launch",
  "name": "Debug Miyabi",
  "cargo": {
    "args": ["build", "--bin=miyabi"]
  },
  "args": [],
  "cwd": "${workspaceFolder}"
}

🛡️ 共通パニック対処

パニック 原因 対処
unwrap() on None Option未処理 if let Some / ?
unwrap() on Err Result未処理 match / ?
index out of bounds 配列範囲外 .get() / bounds check
overflow 算術オーバーフロー checked_* / wrapping_*
stack overflow 無限再帰 再帰ロジック見直し

✅ 成功基準

チェック項目 基準
エラー分類 正確な分類
根本原因特定 原因明確化
解決策提示 具体的な修正方法
再発防止 テスト追加

🔗 関連Skills

  • Rust Development: ビルド・テスト
  • Performance Analysis: パフォーマンス問題
  • Security Audit: セキュリティ問題
GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台
本页面由 陌讯 Skills 聚合平台 收录整理，数据定期更新。