.md
Skill.mdサーチャーJP
Skill.md一覧に戻る
M
v1.0.0

バグの原因を調査し、修正までの道筋を明確にできる

by mae616

0
0

説明

できること

  • バグの原因候補を絞り込める ログ解析、コード検索、環境確認など段階的な調査を実行し、「何が原因で起きているのか」の仮説を精度高く更新できます。
  • 調査内容をIssueに記録できる 実施した調査、観測されたログ、導き出された新しい仮説をGitHub Issue のコメントに自動追記し、チーム全体で調査進捗を追えます。
  • 再現方法や前提条件を明確にできる バグが「いつでも再現するのか」「特定の環境でだけ起きるのか」を確認し、修正時の検証範囲を適切に設定できます。
  • 修正策を立てやすくする 原因が明確になることで「どこをどう直せばいいか」が見えやすくなり、修正時間が短くなります。
  • 同じバグの再発防止に役立つ Issue に記録された調査プロセスと原因が将来の参考資料となり、類似バグへの対応が高速化されます。

こんな人におすすめ

  • バグトリアージを担当するエンジニア バグIssue の内容から効率的に原因を追跡でき、本当に優先すべき不具合を見極められます。
  • フロントエンド・バックエンド開発者 報告されたバグに対して、データドリブンで原因を特定でき、修正の自信度が上がります。
  • QA・テスト担当者 バグの再現条件や観測ポイントを明確にすることで、開発チームへの報告品質が向上し、修正検証が効率化されます。
  • スタートアップやスモールチーム 専任の調査者がいなくても、体系的にバグ原因を追跡でき、チーム全体の対応力が向上します。
SKILL.md の内容
# [バグ対応] 2. トラブルシューティング調査実行と仮説の絞り込み (引数:Issue番号)

## 入力
- `$ARGUMENTS` : 調査対象のバグIssue番号
  - 例: `#123` または `123`

---

## 🎯 目的
- 既存のバグIssueを基に **調査だけを実施** する

Skill.md 情報

バージョン
v1.0.0
カテゴリ
debug
作成日

インストール

ワンコマンドで導入
1

下の「Skill.mdをダウンロード」ボタンを押す

2

お使いのAIツール(Claude Code・Cursor・Copilot など)にファイルをアップロードして「このスキルを追加して」と入力する

ターミナルから追加する場合
$ mkdir -p ~/.claude/skills/ && curl -sL "https://github.com/mae616/ai-template" -o ~/.claude/skills/SKILL.md

タグ

関連 Skill.md

M

バグの原因を証拠に基づいて体系的に特定・修正できる

by moorestech

テストが失敗したり、実装が意図通りに動かない時に、推測や思いつきではなく、ログ出力による「証拠」に基づいてバグの原因を特定できます。 考えられる原因を5~7個列挙し、最も可能性の高いものに絞って検証するため、闇雲なデバッグの時間を大幅に削減できます。 修正後も、デバッグログをすべて削除し、プロジェクト全体の一貫性を保った状態でコミットできます。 テストコードがパスしないトラブルに遭遇したエンジニア 「なぜ動かないのか理由が不明」という状況から抜け出したい方 原因不明のコンパイルエラーやランタイムエラーの対応を効率化したい方 バグ修正時に、問題の根本原因を正確に把握してから対応したいチーム ワークフローは6ステップで構成。Step 1:症状の正確な把握。エラーメッセージ・スタックトレース全文確認、期待値と実際値の差分明確化、再現条件の特定を「期待/実際/エラー/再現」テンプレートで記録。Step 2:仮説の列挙(5~7個)。データ(入力値・初期化順序)、状態(ライフサイクル・タイミング)、依存(他システム連携・イベント順序)、環境(Unity固有・非同期・スレッド)のカテゴリ別に幅広く検討。Step 3:絞り込み(1~2個)。エラーメッセージとの整合性、変更履歴との関連、再現パターンの一致、過去類似バグ経験を判断基準に。Step 4:ログによる仮説検証。問題メソッドの入口・出口、条件分岐直前、データ変換前後に Debug.Log で値を出力。Step 5:検証と修正。ログ結果から原因特定し最小限修正、外れたら新仮説を追加検証。Step 6:クリーンアップ。デバッグログ全削除、プロジェクト一貫性確認。アンチパターンは推測修正・一度に大量変更・ログ残し。

テストコミット
699182026-04-12
N

バグを調査して根本原因を特定

by nahisaho

症状から出発して、ログ・スタックトレース・デバッグツールを活用しながら根本原因を特定できます 5 Why 分析やフィッシュボーン図など体系的な RCA(根本原因分析)手法を使い、表面的な原因ではなく本質的な問題を見つけられます メモリリーク、競合状態、パフォーマンス問題など、複雑なバグのパターンに対応できます デバッグループに陥ったときに自動検出し、別のアプローチを提案して効率的に問題を解決できます GitHub Issue から問題の詳細を抽出し、構造的に調査を進めることができます 本番環境で複雑なバグが発生し、原因が特定しづらい状況に困っている開発者 デバッグに何時間もかかってしまい、効率化したい人 チーム内で「このバグ、何が問題なのか」を説明する必要がある人 パフォーマンス問題やメモリリークなど、実装的な根深い問題に対応したい人 Bug Hunter AI は英語でバグ調査・根本原因分析・フィックス生成を支援するエージェントで、日本語での対話で効率的なデバッグを実現します。得意領域は再現手順(Minimal Reproducible Examples)・ログ分析(エラーログ・スタックトレース)・デバッグツール(ブレークポイント・ステップ実行・変数監視)、および 5 Why・フィッシュボーン図・タイムラインを使った RCA です。バグ種別としてロジックエラー・メモリリーク・競合状態・パフォーマンス問題・セキュリティ脆弱性に対応し、二分探索デバッグ・ラバーダック・分割統治・仮説検証などの戦略を適用します。MUSUBI Agent の StuckDetector モジュールでデバッグループ検出が可能(repeatThreshold: 3、minHistoryLength: 5)で、IssueResolver で GitHub Issue から bug 詳細を抽出(issue number・title・description)して体系的に調査を開始できます。

テストドキュメントセキュリティ
275312026-01-01
U

Webアプリをリアルに自動テストしてバグを検出・修正

by Unson-LLC

Steel.devクラウドブラウザを使い、実ユーザー視点でWebアプリを自動テストし、バグを検出できます。 ページレンダリング、リンク・フォーム機能、エッジケース(空入力、特殊文字、ネットワーク遅延)、JavaScriptエラーを包括的にチェックできます。 検出したバグをCritical/High/Medium/Lowに分類し、Tier(Quick/Standard/Exhaustive)に応じた自動修正ループで品質を向上させます。 テスト実行から修正検証までのワークフローを自動化し、Paperclip Heartbeatで定期的にQAを実行できます。 Web アプリケーション開発チームの品質保証(QA)担当者 継続的デリバリーで定期的な自動テストが必要なスタートアップやSaaS企業 ブラウザの互換性確認やレイアウト崩れ検出を自動化したいフロントエンド開発チーム バグ検出から修正検証までを効率化したいプロダクト開発チーム Dev QA(Browser Testing & Bug Fix Agent)は、Steel.dev クラウドブラウザAPI を使い、Paperclip Heartbeat上でWebアプリを実ユーザー視点でテストします。 環境変数STEEL_API_KEY、PAPERCLIP_API_URL/KEY、COMPANY_ID、RUN_IDを設定後、Heartbeatフローは以下の通り:割り当てIssueを取得 → テスト対象URL・スコープを抽出 → ブラウザセッション作成 → テスト実行・バグ検出・修正・再検証 → レポートをIssueコメントに投稿 → セッション終了。 Steel.dev API操作は、POST /sessions でセッション作成(CDP_URL取得)、POST /actions/navigate でページ遷移、GET /actions/screenshot でスクリーンショット取得、DELETE /sessions でセッション終了。テストプロセスは、IssueからTarget URL・Scope・Tier を抽出。テスト実行ではレンダリング(HTTP 200、レイアウト、モバイル表示)、インタラクション(リンク・フォーム・ボタン・連打耐性)、エッジケース(空入力・特殊文字・遅延・戻る)、コンソール(JSエラー・ネットワークエラー)をチェック。バグをCritical/High/Medium/Low に分類し、Tier別に修正範囲を決定します。

テストAPI設計
64642026-04-01