BugIt3分で読めます

バグか、想定どおりの動作か?登録する前に確認する方法

登録する前に、その動作がバグなのか、機能の不足なのか、意図されたものなのかを確認しましょう。仕様、リリースノート、設定、トラッカーを使う簡単な方法です。

仕様の確認から、バグ、想定どおりの動作、仕様の抜けという3つの結果に分かれる判断の流れ。

最も高くつくチケットの中には、バグではないものがあります。製品は作られたとおりに動いたのに、報告者は別の動きを期待していて、開発者が午前中を費やしてそれを証明する、というものです。逆の場合も同じくらい高くつきます。報告者が設計の内容を示せなかったために、本物のバグが「仕様どおり」として閉じられてしまうのです。

登録する前に数分確認するだけで、こうしたケースの大半は解決します。その方法を紹介します。

信頼できる情報源から始める

動作がバグになるのは、チームで合意した何かと矛盾するときです。その「何か」を、次の順番で探します。

  • 仕様、ストーリー、受け入れ条件。 何が起きるべきかが書かれていて、製品が違う動きをするなら、それはバグです。該当する一文をレポートに引用してください。
  • リリースノートと変更履歴。 変更が告知されているかもしれません。その場合、見ているのは不具合ではなく決定事項です。もっとも、その決定に納得できないこともあるでしょう。
  • ドキュメントとヘルプテキスト。 製品自身の言葉はエビデンスです。ページに書かれていることと画面の動きが違うなら、どちらにしても報告する価値があります。
  • トラッカー。 その動作について、未解決と解決済みの両方のチケットを検索します。「仕様どおり」とされた解決済みのチケットがあれば登録の手間が省け、未解決のチケットがあれば、そこにエビデンスを追加すべきだとわかります。

自分の環境が原因でないか確かめる

「バグ」のかなりの部分は、環境が原因です。何かを書く前に、次の点を確認してください。

  • 権限とロール。 別のロールのアカウントを使うと、動作は変わりますか?
  • 設定とフラグ。 想定していない設定や機能フラグが有効になっていませんか?
  • データ。 新しいアカウント、小さいファイル、別の入力で動作が変わりますか?
  • バージョン。 思っているとおりのビルドを使っていますか?それは仕様が対象としているビルドですか?
  • キャッシュと古い状態。 クリーンなセッションでも同じ結果になりますか?

このうちどれかを変えて動作が消えるなら、確かなことが1つわかったことになります。わかりにくい初期設定やメッセージの欠落のように、それでもバグである可能性はありますが、レポートの内容は変わります。

正直な3つの結論

| わかったこと | 登録するもの | |---|---| | 製品が仕様や自らのドキュメントと矛盾している | バグ。両方を引用します。 | | 動作は意図されたものだが、意外またはわかりにくい | ユーザビリティまたはドキュメントの問題。何に惑わされたかを書きます。 | | 動作は意図されたもので、別の動きを望んでいる | 機能リクエスト。そうとわかるラベルを付けます。 |

正しいカテゴリで登録するのは、杓子定規なことではありません。対応できる人のところにチケットが届き、不具合の件数も正確に保たれます。

仕様に何も書かれていないとき

何が起きるべきかを示すものが何もないこともあります。推測はしないでください。何をしたか、何が起きたか、何を期待していたかを書き、それを扱う仕様がないことをはっきり伝えて、担当者に判断を求めます。そうすれば、曖昧な言い合いが明確な質問に変わります。

「仕様どおり」で片付けられないレポートを書く

バグとして登録するなら、簡単には却下されないようにしましょう。どの情報源を確認したかを書き、期待の根拠となる一文を引用し、手順と結果を示します。リグレッションの報告方法のガイドでは、最後に正しく動作していたバージョンを書き添える方法を紹介しています。これは、現在の動作が設計ではなく変更によるものだという強いエビデンスになります。

BugIt の出番

BugIt は、何かがバグかどうかをあなたの代わりに判断しません。判断すべきでもありません。大まかなメモを受け取り、手順、期待結果、実際の結果を含む構造化されたレポートに変えるので、バグかどうかという問いが見えやすくなります。また、下書きをお見せする前にトラッカーから似たチケットを検索するので、以前の決定を見つけられます。下書きはあなたが確認し、カテゴリもご自身で設定します。BugIt は一般的な個人情報をベストエフォートでマスクし、FILE IT と入力するまで、トラッカーには何も書き込まれません。

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

まとめ

仕様、リリースノート、ドキュメント、トラッカーを確認し、自分の環境が原因でないことを確かめ、エビデンスが裏付けるカテゴリで登録してください。最初に少し確認するだけで、本物のバグは閉じられずに残り、バグでないものは登録されずに済みます。

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

BugIt

日本語