bug-reproduction-brief について
bug-reproduction-briefは、不完全または断続的なバグ報告を、最小限で再現可能な記録にまとめるスキルです。問題を調べるエージェント向けで、再現確認と診断・修正を分けます。
主な機能
- 01正確な失敗状況の記録
- 02検証可能な環境情報の整理
- 03期待結果と実際の結果の分離
- 04最小限の再現手順への縮小
- 05診断前の再現性確認
活用シーン
- 01断続的なバグ報告の整理
- 02環境依存の不具合の再現
- 03安全な失敗テストの準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/bug-reproduction-briefを入力して読み込まれたか確認します。
詳細
バグ再現の概要
バグ報告が不完全な場合、断続的に発生する場合、環境に固有の場合、または原因の推測が含まれている場合に、このスキルを使用します。目的は、診断や修正を始める前に、観測可能な最小限の不具合を立証することです。
1. 観測された不具合を記録する
正確なエラー、誤った出力、タイムスタンプ、影響を受けるルートまたはコマンド、判明している最小の入力を記録します。秘密情報や個人データを含めず、関連するログを保存します。伝聞による説明には、未検証であることを明記します。
2. 環境を特定する
確認できる事実のみを記録します。
- リポジトリとコミット
- ランタイムとパッケージマネージャーのバージョン
- オペレーティングシステムまたはコンテナー
- 依存関係のロックファイル
- 関連する機能フラグ
- 対象がローカル、テスト、ステージング、本番のいずれか
認証情報や本番環境の設定を推測してはいけません。
3. 期待される動作と実際の動作を切り分ける
観測可能な内容を、明確な2つの文で記述します。
Expected: [observable result]
Actual: [observable result, including status or error]
どちらの文にも、原因の推測を書かないでください。
4. 再現手順を絞り込む
報告された手順から始め、関係のないデータ、サービス、手順を一度に1つずつ取り除きます。それでも失敗する最小限のフィクスチャを維持します。失敗しなくなった場合は、最後に取り除いた条件を戻して記録します。
本番環境での再現よりも、分離されたテスト、最小限のスクリプト、または最小限で安全なリクエストを優先してください。
5. 再現性を確認する
安全な場合は、最小限の再現手順を少なくとも2回実行します。コマンドと出力を記録します。断続的に発生する場合は、決定的だと表現せず、観測された頻度と期間を報告します。
6. 修正に着手する前に止める
検証済みの再現手順を成果物とします。この概要を作成する間は実装コードを編集しないでください。証拠が失われたり、診断と修正が混在したりする可能性があります。
出力
# Bug Reproduction Brief
- Target and commit:
- Environment:
- Expected:
- Actual:
- Minimal steps:
- Minimal fixture:
- Reproduced: yes / no / intermittent
- Evidence:
- Unknowns:
- Safe next hypothesis to test:
安全上の境界
- バグを再現するためだけに、本番データを変更しないでください。
- 秘密情報、顧客の記録、非公開のソースコードを公開しないでください。
- 相関関係だけを根拠に根本原因を断定しないでください。
- まず読み取り専用または可逆的な調査を行ってください。
- 再現を検証したら終了してください。診断と修正は別のワークフローです。
プロンプトの例
Use the Bug Reproduction Brief skill on the failing checkout test. Do not fix it yet. Reduce it to the smallest safe failing fixture and report the exact command evidence, expected result, actual result, and remaining unknowns.
ソースとライセンス
https://github.com/skyestrela/ai-agent-skill-preview の MIT ライセンスのワークフローをもとに改変しています。