bug-reporting について
実プロジェクトの不具合報告を支援し、レビューや追跡に使える記録を作成するスキルです。リスクに基づいて優先付けし、前提や不足情報を示して、再現情報を捏造しません。
主な機能
- 01リスクと業務影響による優先付け
- 02タイトル、環境、前提条件の記録
- 03再現手順と実際の結果の整理
- 04期待結果、頻度、影響範囲の記載
- 05前提と不足情報の明示
活用シーン
- 01開発者が再現できる不具合報告の作成
- 02不具合レビュー向けの影響と優先順位の整理
- 03不足情報を明記した報告案の作成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ naodeng/ awesome-qa-skills --skill bug-reportingインストール後、Claude Code で/bug-reportingを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
output-formats.mdquick-start.mdREADME.mdagents/openai.yamlevals/eval.yamlevals/cases/basic-success.yamledge-incomplete-input.yamledge-risk-priority.yamlreview-expected-source-missing.yamlreview-frequency-and-priority.yamlexamples/bug-report-templates/README.mdtemplate-standard.mdoutput-templates/template-csv.csvtemplate-excel.tsvtemplate-json.jsontemplate-markdown.mdtemplate-word.mdtemplate-xmind.mdprompts/bug-reporting.mdreferences/local/CONTRIBUTING.mdFAQ.mdscripts/batch_convert_templates.pyconvert_formats.pyconvert_output_formats.pyconvert_to_csv.pyconvert_to_excel.pyconvert_to_json.pyconvert_to_markdown.pyconvert_to_word.pyconvert_to_xmind.py詳細
翻訳後に原文が更新されています。最新の内容は原文をご確認ください。
バグ報告
中国語版: 対応する中国語スキルを参照してください。
使用する場面
- 実際のプロジェクトの状況に即したバグ報告について支援が必要な場合。
- 実行、レビュー、またはフォローアップにそのまま使える出力が必要な場合。
ワークフロー
- Progressive disclosure に記載されているメインプロンプト(対象範囲、構成、品質基準)を読み、それに従います。
- 結果に影響するプロジェクトのコンテキストのみを追加します。対象範囲、環境、制約、リスク、依存関係、期待する成果物が該当します。
- 入力が不完全な場合は、使える初稿を作成し、前提条件と不足情報を明記します。
- デフォルトでは Markdown を使用します。ユーザーから指定があった場合にのみ形式を変更します。
主な制約
- リスク/ビジネスへの影響に基づいて優先順位を付け、すべてを同等に扱わないでください。
- 確認済みの事実と、現時点での前提条件を分けてください。
- ユーザーが提示していないエンドポイント、フィールド、環境、根本原因を作り出さないでください。
- 出力は実行可能なものにします。具体的なシナリオ、明確な優先順位、明確な次のステップを示してください。
段階的な情報開示
- 出力を作成する前に、
prompts/bug-reporting.mdを読み、そこに記載された要件(最低限含める内容、出力構成、品質基準)に従います。 - Excel/CSV/JSON/Word が指定された場合は、
output-formats.mdを読み、指定された形式を守ります。 - 既製のテンプレートが適している場合は、
output-templates/内の該当ファイルを使用します。 - フレームワーク、トラブルシューティング、スキーマに関する詳細なメモについては、
references/内の関連ファイルのみを読み、ディレクトリ全体を読み込まないでください。 - 形式変換や補助的なチェックには、一から作り直すのではなく、既存の
scripts/を優先して使用します。 - このスキルの評価やリグレッションには、skill-up と
evals/を使用します。
提出前チェックリスト
- メインプロンプトの出力構成に従った
- 最低限の対象項目を網羅した:タイトル、環境、前提条件、再現手順、実際の結果、期待される結果、再現頻度、影響範囲、…(詳細はメインプロンプトを参照)
- 最低限のチェックリストを網羅した、または省略した項目を説明した
- リスクの高い項目に明確な優先順位を付けた
- ユーザーが提示していない詳細を作り出していない
- 前提条件と不足情報を明記した
よくある落とし穴
- 対象範囲やコンテキストが不足しているのに、完全であるかのように装わないでください。
- すべての項目を同じ重要度で扱わないでください。
- 前提条件や情報不足を省略しないでください。
- 現在のツールチェーンに関係のない一般論を羅列しないでください。
コメント
Markdown 対応