こんにちは。グロトムの堀口夏希です。「動きません」と相談したあと、環境や操作手順を何度も聞き直されたことはありませんか。今回は、相手が調査を始めやすくなる質問のまとめ方を、架空の例で紹介します。
期待した結果と、実際の結果を並べる
例えば「申請フォームで保存を押すとエラーになる」だけでは、何を正しい結果としていたかが分かりません。「必須項目を入力して保存できる想定だが、確認画面に進まずエラー表示になる」と並べると、差分が見えます。
表示されたメッセージは、共有可能な範囲で正確に残します。記憶から言い換えると、別の問題として受け取られることがあります。
再現条件は、相手が同じ状態を作れる粒度で
環境、対象の版、入力条件、操作の順番を整理します。「テスト環境で、入力欄Aを空にした場合のみ発生。値を入れた場合は保存できた」という違いがあれば、手がかりになります。
毎回起きるのか、一度だけなのかも区別します。分からないことを推測で埋めず、「まだ再確認していません」と書くほうが、次の確認が明確になります。
試したことは、操作と結果をセットで
「いろいろ試しました」では、同じ確認を繰り返すことになります。「別のテストデータでも同じ結果」「画面を開き直しても変化なし」のように、何を変え、どうなったかを組にします。
試した操作が状態を変えるものなら、その影響も共有します。本番環境での試行は、許可された範囲と手順に従うことが前提です。
そのまま使える、短い相談メモ
目的: 何を実現したいか。
条件: 環境・版・入力・再現手順。
期待と実際: 正しい結果と、起きたこと。
確認済み: 試したことと各結果。
相談したいこと: 判断してほしい点と必要な時期。
緊急の障害報告で、すべての項目が埋まるまで連絡を待つ必要はありません。まず影響と現在分かっている事実を、決められた連絡先へ伝え、追加情報を後から補います。
質問を整える目的は、自分で全部解決することではなく、相手と同じ状況を見られるようにすること。 設計・実装・テストでのやり取りを大切にしたい方は、Javaエンジニアの募集もご覧ください。