26
14

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

コードレビューで「正しいけど刺さる」コメントをして後輩に距離を置かれた話

26
Posted at

はじめに

新人リーダーになったばかりの頃、後輩のPRに「このロジックだと将来バグります。設計から見直したほうがいいです」ってコメントしたことがあるんですよね。
技術的には間違ってなかったと思うんです。実際そのロジックには穴があって、指摘自体は妥当でした。でも次の日から、その後輩がSlackで話しかけてくる回数が明らかに減って、PRのdescriptionも妙に硬くなっていったんです。
正しいことを言ったはずなのに、なんで関係が悪くなるんだろうって、しばらく本気で悩みました。

間違ったアプローチ

当時の自分がやっていたのは、こういうコメントでした。

このロジックだと将来バグります。設計から見直したほうがいいです。
なぜこの実装にしたんですか?普通はこうしませんか?
これは良くないパターンです。修正してください。

一見普通の指摘に見えるんですが、後から振り返ると全部同じ構造をしていて、「コードの評価」のつもりで書いた言葉が「あなたの評価」として読まれてしまう書き方だったんです。
とくに「普通はこうしませんか?」は最悪でした。質問の形をしてるだけに、相手は「反論できない詰め方をされた」と感じてしまう。自分では中立的な問いかけだと思っていても、受け取る側は違う。
『NVC(非暴力コミュニケーション)』の著者マーシャル・ローゼンバーグは、評価や判断を含んだ言葉は、相手にとって「攻撃」として受け取られやすいと指摘しています。技術的な妥当性と、伝え方の暴力性はまったく別の軸にある、ということに当時の自分は気づいていませんでした。

正しい理解

ステップ1: 主語を「コード」から動かさない

「あなたはなぜ〜」ではなく「このコードは〜」を主語にする。これだけで、指摘が人格批判に変わる確率がかなり下がります。

Before: なぜこんな実装にしたんですか?
After:  このロジックだと、Nが大きい時にO(n^2)になりそうです。

主語が変わると、後輩も「自分が否定された」ではなく「このコードに改善点がある」として受け取れるようになるんです。

ステップ2: 指摘の強度をラベル付けする

Googleのエンジニアリングプラクティスでは、コメントに「これは必須(must)」「これは提案(nit)」といった強度のラベルを付けることが推奨されています。強度を明示しないと、些細な言い回しの好みも重大な設計ミスも同じ重さに見えてしまうからです。

nit: 変数名をitemsからorderItemsにすると意図が伝わりやすいかもです
must: nullチェックが抜けているので、ここは修正必須です

このラベルがあるだけで、後輩は「全部直さなきゃ」というプレッシャーから解放されます。

ステップ3: 疑問文で「決めつけ」を避ける

「これは間違っています」と「これ、意図があってこうしてますか?」は、伝える情報量はほぼ同じでも、相手の反応が全然違います。

Before: この設計は間違っています。
After:  ここ、将来的にケースAが増えたときどう対応する想定ですか?

後者は、相手が知らなかった可能性だけでなく、自分が知らない意図があった可能性も残してくれるんですよね。実際、聞いてみたら想定していないエッジケースへの配慮だったりして、こちらが勉強になったことも何度もありました。

ステップ4: 良い部分には必ず触れる

指摘ばかりのレビューは、後輩からすると「ダメ出しされる時間」になってしまいます。『駆動力』を書いたダニエル・ピンクも、内発的モチベーションの維持には「承認されている」という実感が欠かせないと述べています。

このエラーハンドリングの分岐、抜け漏れなく丁寧ですね。
一点だけ、ここのnullチェックだけ確認お願いできますか。

良い点への言及は媚びではなく、相手が安心して指摘を受け取れる土台を作る作業だと考えるようになりました。

ステップ5: 非同期コメントと同期会話を使い分ける

PRのコメント欄で議論が3往復以上続いたら、それはテキストで解決すべき話じゃなくなっているサインです。感情のニュアンスが伝わらないテキストのやり取りは、拗れるほど誤解が増幅されます。

コメント2往復目で結論が出ない → 15分だけ通話しませんか、と提案する

これをルール化してからは、レビューのやり取りが原因で気まずくなることがほぼなくなりました。

おわりに

あの後輩とは、伝え方を変えてから半年ほどかけて、また普通に雑談するくらいの関係に戻りました。技術的な正しさは、伝え方が間違っていると相手に届かないどころか、関係そのものを壊してしまう。
コードレビューは「コードの品質を上げる場」であると同時に「チームの信頼を積み上げる場」でもあるんだなと、痛い思い出とともに学びました。今もコメントを書く前に、一呼吸置いて「これは主語がコードになっているか」を確認するようにしています。

26
14
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
26
14

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?