テクノロジー
受入テストを開発者なしで回す準備物
受入テストを「開発者以外」に任せたはずなのに、手順の質問や環境のトラブル対応で結局エンジニアが呼ばれる。リリース前によくある光景です。原因は担当者の力不足ではなく、手順・環境・報告経路の3点が揃っていないことにあります。この記事では、PM・QA・CSが自走して受入テストを回すための準備物を整理します。
なぜ受入テストは開発者に戻ってくるのか
戻ってくる理由は、たいてい次の3つに分類できます。
- 手順が頭の中にある:「ログインして、あの画面で、普通に操作して」で伝わると思われている
- 環境が不安定:テスト用アカウントが無い、データが古い、誰かが先に使ってしまった
- 報告の行き先が不明:不具合を見つけても、どこに何を書けばよいか分からずチャットで口頭報告になる
この3点を事前に潰しておけば、開発者の出番は「本当に直すとき」だけになります。
1. 手順:操作を「誰が読んでも同じ結果になる」形にする
手順書は、初めて画面を見る人が読んでも迷わない粒度で書きます。次の書式がおすすめです。
手順書の1項目の例
- 前提:テスト用アカウント A(権限:一般)でログイン済み
- 操作:「注文一覧」を開き、1件目の「キャンセル」ボタンを押す
- 期待結果:確認ダイアログが出る。「はい」で状態が「キャンセル済み」に変わる
- 確認:一覧に戻っても「キャンセル済み」のままである
ポイントは「前提」と「期待結果」を必ず書くことです。期待結果が無いと、テスターは画面が変でも「これが仕様かもしれない」と判断を止めてしまいます。
2. 環境:開始前に5分で確認できるようにする
環境の問題で止まる時間を減らすため、テスト開始前の確認リストを用意します。
- テスト用URLと、本番URLとの見分け方(画面上部の帯、ドメイン名など)
- テスト用アカウントの一覧と、権限・パスワードの保管場所
- テストデータの状態(いつ時点のものか、リセットの方法と担当者)
- 同時に使う人がいる場合の担当範囲の割り振り
- テストに使ってよい外部連携(決済はテストモード、メールは送信先を限定、など)
失敗例として多いのは、複数人が同じアカウント・同じデータを使って結果が食い違うケースです。担当ごとにアカウントを分けるだけで、「再現しない」という報告の多くが消えます。
3. 報告経路:書く場所を1つに決める
受入テストで最も荒れやすいのが報告です。チャット、メール、スプレッドシートに分散すると、重複と抜け漏れが出ます。次のルールを決めておきましょう。
- 報告先は1か所だけにする(口頭・チャットで見つけたものも必ずそこへ転記)
- 最低限書く項目:どの画面で、何をして、何が起きたか、期待した結果は何か
- スクリーンショットは必須。赤枠などで問題箇所を示す
- 優先度は「リリースを止めるか」の1軸だけで判断する(止める/止めない)
詰まりやすい箇所と対処
- 「仕様どおりか分からない」:手順書に期待結果を書き、迷ったら報告してよいと明言する。報告は多すぎる方が安全
- 「再現しない」と言われる:操作手順と使ったアカウントを報告に含める習慣をつける
- 本番の問い合わせと混ざる:受入テストの報告にはテスト環境であることが分かる印を付ける
Bugoon での実践
Bugoon は、サイトにタグを1行埋め込むだけで、ブラウザ上からそのままバグ報告ができるサービスです。受入テストの報告経路を1本にまとめる用途に向いています。
- テスターは画面上のウィジェットから報告するだけ。スクリーンショットへの注釈と、直前の操作ステップの記録で、「何をしたか」を文章に頼らず残せます
- 報告にはURL・ブラウザ・OSといった環境情報が付くため、「どの環境で出たか」を聞き返す往復が減ります
- 報告は GitHub Issue と連携し、カンバンボードで状況を共有できます。iOS / Android アプリからも報告できるため、モバイルの受入テストにも使えます
なお、テスト環境と本番環境の報告を自動で振り分けられるとさらに扱いやすくなりますが、現時点ではプロジェクトを分けるなどの運用で区別するのが現実的です。まずは手順・環境・報告経路の3点を、小さく整えるところから始めてみてください。
← 記事一覧に戻るBugoon Blog