BugIt4分で読めます

バグを登録する前に重複を見つける

1つのバグが複数のチケットになってしまう理由、以前のチケットを見つけるためのトラッカーの検索方法、そして見つけたときにすべきこと。

バグの説明から、症状とエラー文での検索、候補の確認を経て、エビデンスの追加、関連としてのリンク、新規登録のいずれかに進む流れ。

サインイン画面のバグを思い浮かべてください。月曜日、テスターが「ログインのスピナーが回り続ける」と書きます。火曜日、サポートエンジニアが「パスワード画面の後にサインインできない」と書きます。水曜日、開発者がトークン更新時のタイムアウトに触れた3件目のレポートを見つけます。

チケットが3件、担当者が3人、バグは1つ。それぞれのチケットが答えの一部を持っています。1件目には手順が、2件目には待っているお客様が、3件目にはログがあります。誰にも全体像が見えず、誰かが同じ問題を3回トリアージすることになります。

重複は、不注意な人がいる証拠ではありません。別々の人が同じものを別々の言葉で説明すると、こうなるのです。朗報は、登録前に少し検索するだけで大半を防げること、そしていくつかの習慣で残りも管理しやすくなることです。

単純なキーワード検索で見落とす理由

「スピナー」で検索しても「サインインできない」は見つかりません。「ログイン」で検索しても「認証」は見つかりません。トラッカーは大きくもなっていきます。探しているチケットは、閉じられているかもしれないし、名前が変わっているかもしれないし、何百件もの新しいチケットの下に埋もれているかもしれません。

ですから、検索には少しコツが必要です。数分で済む手順を紹介します。

登録ボタンを押す前の6つの手順

  1. 自分のタイトルではなく、症状で検索する。 ユーザーが目にする言葉を使います。画面上のメッセージ、画面の名前、失敗した操作です。
  2. エラー文で検索する。 例外名やステータスコードがあれば、それで検索します。開発者はよくこれらをチケットに貼り付けるので、完全に一致します。
  3. 同義語を試す。 クラッシュ、フリーズ、ハング、スピナーは、1つの不具合を指していることがあります。ログイン、サインイン、認証も同じです。
  4. 領域で絞り込む。 使っていた製品の部分に対応するコンポーネントやラベルで絞り込み、一覧を読める量まで減らします。
  5. 閉じたチケットも含める。 直ったはずのバグが戻ってきたならリグレッションです。古いチケットには経緯があり、ときには原因も書かれています。
  6. リンクをたどる。 一致するチケットは、すでに見つけたチケットからリンク1つ先にあることがあります。

似たチケットが必ずしも重複とは限りません。誤ったものを統合すると、バグが隠れてしまいます。

  • 重複: 症状も原因も同じ。チケットは1つの問題を説明しています。
  • 関連: 症状は同じでも原因が違う、または領域は同じでも症状が違う。チケットは分けたままにして、リンクします。
  • 別物: 言葉が一致しているだけ。そのままにしておきます。

判断できないときは、関連として扱ってリンクしてください。リンクにかかるのは数秒です。その領域の担当者が、あなたより多くの知識をもとに、後から統合できます。

一致するチケットを見つけたら

以前のチケットを見つけるのは、終わりではなく始まりです。見つけたものを役立てましょう。

  • 新しい情報を追加する。 あなたのビルド、手順、ログ、または別のお客様も影響を受けているというメモです。エビデンスは、チケットにとって多すぎて困ることのない唯一のものです。
  • 「私も」チケットは作らない。 自分も同じ現象を見たと伝えるために2件目のチケットを作ると、エビデンスがまた分散します。1件目にコメントしてください。
  • 再オープンは慎重に。 一致したチケットが閉じられていて、それでも問題を再現できる場合は、チームのやり方に従います。再オープンするか、元のチケットへのリンクを付けて新しいチケットを登録します。
  • 別の人の意見を求める。 迷ったら、自分のチケットを登録し、候補のチケットを関連としてリンクします。判断はトリアージ担当者が行います。

チームで重複を減らす

一人ひとりの検索も役立ちますが、チームの習慣はもっと役立ちます。トラッカーはチームの共有の記憶であり、次の人が見つけられるように書かれていて初めて機能します。

  • タイトルの形式を決める。 ある領域のチケットが似た書き方になっていれば、並べたときにまとまり、重複が目立ちます。
  • コンポーネント用のラベルは少数に絞る。 一貫して付ければ、絞り込みで見つけるべきものが見つかります。
  • 重複はリンクして閉じる。 残すチケットにリンクすれば、経緯をたどれる状態が保たれます。
  • トリアージでは最新のチケットにざっと目を通す。 昨日から届いたものを5分で確認すれば、記憶が新しいうちに重複のペアを見つけられます。

簡単な例

レポートを PDF に書き出すとクラッシュするとします。最初に「書き出し クラッシュ」で検索しても何も見つかりません。そこで画面上のメッセージ「ファイルを生成できませんでした」で検索すると、「大きなレポートで PDF ボタンが反応しない」というタイトルのチケットが出てきます。言葉は違っても症状は同じで、手順もあなたのものと一致します。

新しいチケットは登録しません。ビルドとログの行をコメントで追加し、同じ書き出し画面に触れていたもう1件のチケットをリンクします。2分で済み、新しいチケットは増えず、次にそのチケットを開く開発者には全体像が見えます。

BugIt の出番

トラッカーをきちんと検索するには根気が要り、急いでいるときにこそ飛ばされがちな手順です。BugIt はそれを代わりに行います。バグを説明すると、BugIt は下書きをお見せする前に、トラッカーから似たチケットを検索します。検索は読み取りのみです。候補ごとにスコアを付けるので、どのくらい近いかを判断でき、下書きには関連チケットが一覧表示されるので、ワンクリックでリンクできます。クイックバグとして報告する場合、この検索は行われません。

これは手がかりであって、判定ではありません。下書きはすべて登録前にあなたが確認し、BugIt は一般的な個人情報をベストエフォートでマスクします。FILE IT と入力するまで、トラッカーには何も書き込まれません。

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

まとめ

重複は、同じ問題を別の言葉で表すことから生まれます。症状とエラー文で検索し、同義語を試し、閉じたチケットも含め、リンクをたどってください。一致するチケットを見つけたら、新しいチケットを作るのではなく、そこにエビデンスを追加します。2分の検索で、チームは同じバグを何度も修正し、トリアージし、説明する手間から解放されます。

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

BugIt

日本語