この記事の結論

新人エンジニアは、チームが認める環境と権限、チケットの目的と完了条件を確認して作業します。詰まりは資料完成を待たず共有し、動作・変更意図・検証・未確認を分けてレビューへ渡します。レビューとリリースの手続きは会社の運用に合わせ、本番異常は正式な経路へ速やかに知らせます。

学習では進められたのに、実務のチケットを前にすると手が止まる。そのとき分からないのは、コードの書き方だけとは限りません。使ってよい環境、自分の権限、聞く相手など、まだ確かめていない条件があります。「一人で解けるまで聞けない」と考えると、その条件の確認まで遅れてしまいます。

新卒エンジニア一年目は、承認された環境と完了条件を確認し、作業結果と未確認をチームへ共有して進めます。 動くこと、意図を説明すること、必要な検証をすることは、どれか一つでほかの二つの代わりにはなりません。

ここではチーム開発の仕事の流れを扱います。具体的な環境構築コマンドや本番復旧の操作は、勤務先の現行手順と担当者に確認してください。

新人エンジニアの環境構築は、手順・権限・データの扱いを先に確認する

使う端末、リポジトリ、開発環境、必要なアカウントを、チームの手順で確認します。手順が古い、必要な権限がない場合は、その不足を担当者へ伝えます。個人のアカウントを使ったり、設定を自分の判断で変えたりして、代わりに進めることはしません。

作業する環境が、開発・共有・本番のどれなのかも区別します。練習できる環境と、顧客や他の作業に影響する環境は同じ扱いにはできません。ログやテストデータを外部へ渡してよいかも、会社のルールで確かめてください。

環境構築で止まった場合も、「できません」だけでなく、どの手順で止まったかを伝えられます。たとえば次のような短文です。

チームの手順書に沿って進めていますが、共有の開発環境に入るところで「アクセスできません」と表示されます。権限の申請が必要なのか、ほかに確認すべき点があるのかを教えてください。

画面やログを添えるときは、社内で指定された場所に、共有してよい範囲を載せます。原因が分からない段階でも、手順書の該当箇所と止まっている場所は相談材料になります。

学習でも共同作業はあり、実務でも一人で進める範囲はあります。学習と実務の違いを先に決めつけるより、今回使う環境と権限、確認先を一つずつ明らかにします。

環境が使える状態になったら、次はチケットの「終わり」をチームと合わせます。

エンジニアのチケットは、目的と完了条件・変更範囲を合わせる

チケットは、チームが依頼や不具合を管理する作業単位です。受入条件は、その作業を完了と判断するために確かめる条件を指します。

「ログイン後の遷移を直す」だけでは、誰をどこへ遷移させ、何を確認すれば完成かが分かりません。依頼の目的、受入条件、対象の環境や画面を確認します。

たとえば、チームと確認した架空のチケットなら、次のように読めます。

確認する点今回のチケットの例
目的通常の利用者がログイン後に自分の一覧画面へ進めるようにする
完了条件承認された開発環境で指定の一覧画面へ進め、チームと決めた関連テストを満たす
変えない範囲ログイン失敗時の表示や、管理者用画面の遷移は今回変更しない
必要な検証対象の遷移と、チームが指定する関連テストを確認する
まだ分からないこと変更する処理が、ほかの入口からも使われているか

「今回は変えない画面」と「影響がないことを確認できた画面」は別です。共有の処理を変えるなら、対象外の画面にも影響しないかを調べる必要があるため、分からないところを先に示します。

変更範囲が読めない場合は、「この画面を対象と考えていますが、ほかへの影響は未確認です」と共有できます。影響をすべて把握できるまで、相談を待つ必要はありません。

必要な調査や検証の範囲をチームと合わせたら、その条件で作業します。推測した完了条件を、自分だけの判断で満たしたことにしないようにします。

完了条件をチームと合わせた後でも、作業の途中で手が止まることはあります。

新人エンジニアの質問は、詰まりと分かる結果から共有する

目的や権限が分からないとき、他の作業に影響があるとき、期限が迫っているときは、先に相談します。通常の調査も、いつ共有するかをチームと合わせておくと、抱え込みに気づく手がかりになります。決めた時刻まで相談してはいけない、という意味ではありません。

杏は、相談の材料として次の点を見ています。

やりたいこと、期待と実際、試した結果、対象環境などは、相手が状況を確かめる助けになります。ただし、すべての欄を埋めることや、原因を再現しきることを、連絡の条件にはしません。

次は架空の相談例です。操作を勧める手順ではなく、確認済みと未確認を分ける記録として見てください。

開発環境でログイン後の遷移先を変更したいのですが、対象画面で404になりました。設定値は確認しましたが、ほかの画面への影響は未確認です。調査する箇所を相談したいです。

もう少し説明できるなら、「設定値を確認した」の中身を足します。たとえば「手順書にある遷移先と設定値は一致していましたが、404の理由は分かっていません」と書けば、相手はどこまで確認したかを読めます。404という結果だけで、原因まで判明したことにはしません。

仕様が決まっていないのか、実装方法が分からないのかでも、相談先は変わります。「正しい遷移先自体を確認したい」のか、「決まっている遷移先へ進まない原因を調べたい」のかを分けると、誰に聞くかを選びやすくなります。

試していないことを「試しました」と書かず、実際の結果を残します。次の直央との会話も、いま分かる材料を渡して相手と状況を合わせる話です。

森川直央

物流でも同じかも。トラブルのとき、「困ってます」だけで電話すると長引くけど、分かる伝票番号や時刻を添えると、相手も状況を確かめやすくなる。

久保田杏

それです。四つの材料は、相手のためでもあるけど、揃えている途中で自分で原因に気づくことも多いんですよ。

調査と質問の一般的な分け方は、仕事の学び方と質問で確かめられます。技術の不明点は、そこで選んだ確認先と、チームの資料へ戻します。

エンジニアの検証は、期待した動作と確認範囲を分ける

変更した画面が一度動いただけで、必要な確認がすべて終わったとは限りません。チケットの完了条件とチームのテスト手順に沿って、何をどの環境で確かめたかを残します。

残すときは、確認できた範囲と、未実施・未確認の範囲を分けます。再現条件や前提が違うなら、それも添えてください。必要なテストに届いていない場合は、未確認を隠さず、レビューの場や担当者へ相談します。

次は、先ほどのチケットを修正した後の架空の検証記録です。まだ確認が終わっていない箇所も含めています。

確認対象今回の結果残っていること
通常利用者のログイン成功後指定の開発環境で、一覧画面が表示された実施条件と使ったテストデータを社内記録に残す
ログイン失敗時の表示まだ実施していないチーム指定の方法で確認する
別の入口から同じ処理を使う場合利用箇所の調査中必要な検証範囲を担当者と合わせる

この状態で「動作確認済み」とだけ書くと、未実施の項目まで終わったように見えます。「一覧画面の表示は確認済み、失敗時は未実施」と分けて書きます。未確認を共有できたことと、完了条件を満たしたことも別です。

この記録が、そのままレビューする相手の判断材料になります。

初めてのコードレビューは、変更の意図・検証・未確認を添える

PR(プルリクエスト)は、コードの変更をチームへ提案し、確認や議論を進めるために使います。

チームが使うPRやレビュー依頼に、何を変えたか、なぜ変えたか、確認したことと残る不明点を添えます。Googleの変更説明ガイドも、変更の内容と理由が伝わる説明を重視しています。会社の依頼様式があれば、その欄に合わせます。

たとえば「遷移先の参照を修正。開発環境の対象画面で確認済み。別の利用箇所への影響は未確認」と書けば、確認範囲を読み違えにくくなります。実施していない確認まで、済んだことにはしません。

検証が残っている段階で方針を相談したいなら、その目的を明示します。次は、完了した変更の承認依頼ではなく、途中の相談をする例です。

ログイン後の遷移先を修正しています。目的は、通常の利用者を自分の一覧画面へ進めることです。

開発環境で対象の遷移は確認しましたが、失敗時の表示は未実施です。別の入口からの利用箇所も調査中のため、影響範囲の見方を相談したいです。

確認してもらうチケットや変更へのリンクも添えます。調査と検証が進んだら、説明の「未確認」も実際の結果に合わせて更新し、完成した変更へのレビュー依頼と区別します。

指摘は、修正すること、意図を確認すること、方針を相談することに分けて対応できます。分からない指摘には、その理由を聞けます。GitHubの公式レビュー案内にも、コメントや変更要求、承認の区別があります。自分のチームで、どの判断と手続きが必要かを確認します。

指摘の意味が分からなければ、「この処理は、どの利用条件を考慮して分ける必要がありますか」のように、分かっていない点を尋ねられます。意図を確かめず、指摘された文字だけを書き換えて終わらせないようにします。

修正後の返答には、変更内容と再確認した範囲を添えます。たとえば「処理を分け、開発環境で通常の遷移を再確認しました。未実施だった失敗時の表示も確認済みです。別の入口はまだ確認中です」と返せば、レビューする人も残る作業を追えます。実際には確認していない結果を、例文に合わせて書いてはいけません。

レビューの完了とリリースの実施も、会社の運用で確かめます。承認されたからといって、自分で本番に反映してよいとは限りません。

エンジニアが本番の異常に気づいたら、正式な連絡と手順を優先する

本番や共有環境で異常に気づいた場合は、資料の完成や、原因を一人で再現できるのを待たずに連絡します。勤務先の手順に沿って緊急連絡先へつなぎ、時刻、分かる操作、観測した状態を伝えます。

許可のない追加操作や自己判断の復旧は避け、指定担当の指示を確認します。記録を消したり見やすく整えたりせず、会社の方法で保全します。ログや画面に機密が含まれる可能性もあるため、個人アカウントへ移して共有しません。

一般的な初動は仕事でミスしたときの対応で確認できます。具体的な復旧は、現行の手順と担当者へ戻します。

新人エンジニア一年目ロードマップを、次のチケットで使う

新人エンジニア一年目ロードマップは、承認された環境と完了条件から、作業・相談・検証・レビューへ進む見取り図です。新しいメモアプリを用意しなくても、普段のチケットやレビュー記録に確認済みと未確認を残せば、そのまま使えます。

次のチケットでは、前回止まったところを一つだけ準備へ戻してみてください。環境が不明で止まったなら着手前に作業場所を確認する、レビューで検証範囲を聞かれたなら条件と結果を分けて残す、といった一動作です。

チケットが完了した数だけでなく、「不明点を共有できた」「指摘の理由を確認できた」「修正後に同じ条件で確かめられた」ことも、先輩との振り返りに使えます。担当を広げる時期は、勤務先の育成方針と実際の作業を見て相談します。

残した未確認を見直すと、自分で調べられそうなものと、聞かないと進まないものが混ざっていることがあります。その分け方で迷ったら、仕事の学び方と質問へ進みます。今回の記録から、次に自分で確かめることと、チームに確認することを選べます。