BugIt3分で読めます

顧客からの苦情を、エンジニアが対応できるバグレポートに変える

サポートと QA が、顧客からの曖昧な苦情をバグレポートに変える方法:適切な質問をし、見たことと推測したことを分け、個人情報を守ります。

顧客の苦情からバグレポートまでの3つのステップ:言われたこと、再現できること、そしてレポート。

お客様からこんなメッセージが届きます。「書き出し機能が壊れていて、作業が消えました。直してください。」怒っていて、急ぎで、エンジニアにとってはほとんど役に立ちません。出発点も、手順も、ビルドもなく、製品の不具合なのか、お客様のファイルの問題なのかを見分ける手がかりもありません。

間に立つサポートや QA の担当者は、このメッセージを、何度もお客様に問い合わせることなくエンジニアが対応できるものに変えなければなりません。その方法を紹介します。

見たことと推測したことを分ける

お客様は結論を報告します。「データが消された」「落ちている」「アップデートで壊れた」。その下には、それぞれ観察した事実があります。最初の仕事は、それを見つけることです。

  • 「データが消された」は、プロジェクトを開いたら一覧が空だった、ということかもしれません。
  • 「落ちている」は、サインイン後にページにエラーが表示された、ということかもしれません。
  • 「アップデートで壊れた」は、月曜日には動いていて、お客様が火曜日にアップデートした、ということかもしれません。

レポートには観察した事実を書きます。結論は、誰の言葉かを明記して引用し、背景情報として残します。エンジニアは「空の一覧」には対応できますが、「消された」には対応できません。

再現の鍵になる、いくつかのことを尋ねる

長いアンケートは無視されます。次の質問で、たいていはエンジニアに必要なことがそろいます。返事は数行で十分です。

  • 問題が起きる直前に何をしていましたか?
  • 何を期待していて、代わりに何が表示されましたか?コピーできるメッセージはありますか?
  • 一度だけでなく何度か起きていますか?毎回起きますか?
  • どのバージョンまたはビルドで、どのデバイスまたはブラウザですか?
  • 以前は動いていましたか?そうであれば、最後に動いていたのはいつですか?

文章で書くのが大変そうなら、スクリーンショットや短い録画を送ってもらう方法を提案します。相手が出しやすいものをお願いしましょう。

エスカレーションする前に再現を試みる

お客様の手順をたどって問題を確認できたなら、その手順とともにレポートに書きます。確認できなかった場合も、何回試したかとあわせてそう書きます。「現在のビルドで2回試したが再現できず。お客様は古いビルドで発生と報告」は役に立つ一文です。エンジニアはどこから始めればよいかがわかり、1時間を無駄にせずに済みます。

以前の報告がないか確認する

苦情は繰り返されることがよくあります。お客様の言葉と、あなたが書いた症状の両方でトラッカーを検索し、解決済みのチケットも確認します。一致するものがあれば、新しく作るのではなく、そのチケットに今回のお客様の件を紐付けます。上手な検索のしかたは、バグを登録する前に重複を見つけるの記事で紹介しています。

チケットに個人情報を入れない

サポートのメッセージには、名前、メールアドレス、アカウント番号、そして誰も共有するつもりのなかった情報まで写ったスクリーンショットが含まれていることがあります。エンジニアがそれらを必要とすることはめったにありません。プレースホルダーや、自社のシステムで照合できる短い参照番号に置き換え、画像は問題が写っている部分に切り抜きます。

影響は事実で伝える

エンジニアには影響の大きさが必要ですが、形容詞を並べる必要はありません。お客様が何をできなかったか、回避策があるか、ほかにも報告があるかを書きます。優先度の判断はトリアージに任せ、事実を説明欄に書きましょう。

短いテンプレート

`` 概要:どこで、何が起きたか、重要な条件 お客様の報告(引用):... 見たこと:... 期待結果:... 手順(お客様の説明どおり、またはこちらで再現したもの):... ビルドとデバイス:... 発生頻度:... 以前は動いていたか?最後に正常だったビルド:... 回避策:... 関連チケット:... ``

BugIt の出番

サポートや QA は、雑然としたメッセージから構造化されたレポートを書く作業を、1週間に何度もこなしています。お客様の言葉をアシスタントに貼り付けて、わかったことを伝えると、BugIt はその大まかなメモを、手順、期待結果と実際の結果、環境を含む構造化されたレポートに変えます。下書きをお見せする前に、トラッカーから似たチケットも探します。一般的な個人情報はベストエフォートでマスクするので、下書きはご自身でも確認してください。レポートはあなたが確認し、FILE IT と入力するまで、トラッカーには何も書き込まれません。

詳しくは taskivator.com/bugit と bugit.dev をご覧ください。

まとめ

苦情の下にある観察した事実を見つけ、的を絞った質問をいくつかし、再現を試み、登録する前に検索し、個人情報を入れないようにします。エンジニアがチケットだけで作業を始められるようにしましょう。

提供中AI アシスタント向け QA エージェント

BugIt

日本語