エンジニアの質問の仕方|何が分からないか分からないときの相談例

仕事・チーム開発

エンジニアの質問の仕方|何が分からないか分からないときの相談例

「何が分からないの?」と聞かれても、そこを説明できない。質問文を書く手まで止まったら、まず見えている状況から相談できます。

先に結論

  • 目的・止まった操作・見える結果を送る。原因や仮説がなくても、相談は始められる。
  • 調べた分だけ、操作と結果を足す。観察したことと、まだ確かめていない考えを分ける。
  • 困りごとの影響で、相談する時点を決める。期限や安全に関わる場合は、調べ終わるまで待たない。

架空の問い合わせ管理を題材に、整理できていないときと、少し調べた後の相談文を紹介します。「件名は必須・1〜100文字」は説明用の仕様で、実際の職場のルールではありません。

分かる三つから相談する

登録画面に件名を追加したいのに、保存処理がどこか分からないとします。「保存処理を調べてから聞こう」では、まさに分からないことが質問の前提になってしまいます。

相談例|まだ調べ方が分からない

問い合わせの登録画面に、必須の件名を追加したいです。画面の入力欄は見つかりましたが、登録ボタンを押した後の保存処理を追うところで止まっています。

今見ている画面とファイルを共有するので、最初に追う場所を一緒に確認してもらえますか。まだ調べる言葉も整理できていません。

ファイル名が分からなければ「今見ている場所を画面共有できます」で構いません。エラーが出ていないなら、無理にエラーメッセージ欄を埋める必要もありません。

今ほしい助けを一言添えます。「調べる場所を教えてほしい」「資料の読み方を確認したい」「状況整理を手伝ってほしい」なら、相手も答え方を選べます。

整理できた分だけ具体的にする

相談は目的と現状から始め、調査結果、自分の案を分かった範囲で追加する三段階。
仮説がなくても最初の段階から相談できる。
  • 調べ方も分からない:目的・止まった操作・見える結果を送り、調べ始める場所を決める。
  • いくつか調べた:試したこと・結果・残った疑問を送り、次の確認候補を絞る。
  • 方針を考えた:自分の理解・案・迷う理由を送り、理解や判断が合うか確かめる。

これは進級表ではありません。別の機能なら、また最初の段階から相談してよいのです。仮説を書けない項目は、そのまま伝えます。長文になったら、最初に見てほしい情報を冒頭へ出しましょう。

調査後は、操作と結果を組にする

登録処理の入口は見つかったものの、空の件名が保存され、どこへ入力チェックを置くか迷っている場面です。

相談例|少し調べた後

件名を必須にする改修で、入力チェックを置く場所を相談したいです。

手元の開発環境で、件名を空にして登録すると保存されました。画面の登録処理と、保存を受け付ける処理を読みましたが、既存の必須チェックがどこにまとまっているか判断できていません。

画面だけ直すと別の入口から空の件名が保存される可能性があると考えています。参考にする既存機能を教えてもらえますか。

「保存された」は観察、「別の入口から保存される可能性」は仮説です。分けて書けば、まだ調べていないことを確認済みに見せずに済みます。

「いろいろ調べた」ではなく、どこを見て、何を試し、何が分かったかを組にします。検索ページを全部並べず、今の疑問に関係する情報を添えてください。

環境差が影響しそうなら、手元の開発環境か共有の検証環境か、どの作業版を見ているかも加えます。不明なら「環境名の確認方法も教えてほしい」と書けます。

相談の時点は、作業への影響で決める

「まず30分調べる」といった目安も、すべての状況には当てはまりません。期限が迫る、ほかの人を待たせる、今日方針を決めないと明日の確認に進めない、といった場合は原因が分かる前でも共有します。

余裕があり、自分の環境で安全に調べられるなら「関連処理を一つ追い、進めなければ相談する」と区切れます。経過時間だけでなく、次に確かめる対象があるか、作業への影響が出ているかを見ます。

依頼時には、相談先と連絡手段、不在・返答がない場合の相談先、途中経過を返す時点を確認しておきます。相手が集中している時間はチャットへ残すなど、チームの約束も使ってください。

ここに注意|操作と情報共有の範囲

本番データや権限など、操作してよいか分からない場合は、試行を増やす前に担当者へ確認します。

ログや画面は必要箇所に絞り、顧客情報・パスワード・トークン・個人の連絡先が含まれないか確かめます。社内情報を公開掲示板や外部サービスへ貼ってよいとは限りません。

伏せると現象が伝わらない場合は、共有が認められた場所か、架空の値での再現を相談します。加工したログは原文の記録と区別し、伏せた箇所があることも添えます。

教わったら、次にすることを返す

「ありがとうございます」に、自分が次にすることを一文足します。たとえば「まず既存の登録機能から入力チェックの置き方を確認します。同じ形にできなければ、違う点を添えて相談します」と返せます。

口頭の説明も要点を相談した場所へ残すと、認識のずれに気づけます。進まなかったときは、前回から何が変わったかを続けて伝えられます。文章を整理したい場合は、確認メールを読みやすくする例も参考になります。

送る前のチェック

  • 目的・止まった操作・見える結果を書いたか。
  • 分かる範囲の調査結果と、ほしい助けを添えたか。
  • 観察と仮説を分け、未確認を確認済みに見せていないか。
  • 共有してよい情報か確かめ、相談する時点を逃していないか。

いま質問文で止まっているなら、まず分かる三つを書いてみてください。整理を一緒に進める相談も、仕事を進める質問です。

-仕事・チーム開発
-