2026 年が終わる前に何かやるか ... とアドベントカレンダーまでの 100 日間を IT エンジニアのお仕事と、AI を雑多に考える質問を元に何等か話を膨らませて書いていこうと思い立ち始めたポエム。仕事のレビューと人格評価を切り離すには、どうすればいいか。
難しいですよね。書いたソースコードのレビューを自分が攻撃されているかのように感じてしまったり、逆にレビュアーとして攻撃しているように聞こえさせてしまったり、そうなってしまうと純粋にコードの評価ができなくて誰も得なことが無いのに、でも人が作ったものである以上誰かに指摘しているように聞こえちゃう。どういう表現でレビューすると良いのだろうか。
コードレビューで使える言い換えをまとめてもらった。
| 避けたい表現 | 代わりに使いたい表現 |
|---|---|
| 「なんでこんな書き方をしたんですか?」 | 「この実装を選んだ理由を教えてもらえますか?」 |
| 「このコードは読みにくいです」 | 「この条件分岐を関数に分けると、処理の意図が伝わりやすくなりそうです」 |
| 「普通はこう書きます」 | 「このプロジェクトでは〇〇の書き方に統一しています」 |
| 「この実装は間違っています」 | 「入力が null の場合、この処理では例外が発生しそうです」 |
| 「ちゃんとテストしましたか?」 | 「この境界値についてもテストケースを追加できますか?」 |
| 「設計を理解していないようです」 | 「この実装だと、既存の設計方針と異なる部分があります」 |
| 「前にも指摘しましたよね」 | 「以前のレビューで合意したルールを、今回も適用したいです」 |
共通するのは、人格や能力を推測せず、観察できる事実と改善案を示すこと。確かにその通り... 以下は参考になる記事。
- Google Developers Japan:コードの健全性 — 礼儀正しいレビュー == 役立つレビュー(日本語)
- Google Engineering Practices:How to write code review comments(英語)
- Conventional Comments(英語)
人に対するバイアスを取り除くには、どうすればいいと思う? #ポエム - Qiita
「仕事ができる人」って、結局どんな人だと思う? #ポエム - Qiita
早く答えることと、正しく答えること、どちらが大事だと思う? #ポエム - Qiita
「分かりません」と言えることも、技術力だと思う? #ポエム - Qiita
難しいことを簡単に話すのも、エンジニアリングだと思う? #ポエム - Qiita
どんな人を見ると「技術力が高そう」と感じる? #ポエム - Qiita
エンジニアの技量って、どうやって測ればいいと思う? #ポエム - Qiita
「IT に詳しい人」と「IT エンジニア」は、何が違うと思う? #ポエム - Qiita
「便利屋」と「エンジニア」の境界線はどこにあると思う? #ポエム - Qiita
「何も作らないこと」が最善のエンジニアリングになることはある? #ポエム - Qiita
問題を解くことと、問題そのものを小さくすること、どちらが大事? #ポエム - Qiita
「とりあえず調べます」と言える人は、なぜ強いと思う? #ポエム - Qiita
あえて即答しないほうがいいのは、どんなとき? #ポエム - Qiita
技術的には正しいのに、うまくいかないのはなぜだと思う? #Security - Qiita
一回の失敗から「この人はダメ」と判断しないためには、どうすればいい? #ポエム - Qiita
知っていることを全部説明しないことも、技術だと思う? #ポエム - Qiita
質問が上手い人は、何を見ていると思う? #ポエム - Qiita
ベテランの「なんか変だ」は、どこから来ると思う? #ポエム - Qiita
IT エンジニアにとって「経験」って何だと思う? #ポエム - Qiita
複雑なものを紐解くことも、エンジニアの仕事だと思う? #ポエム - Qiita
AI に全部聞けるのに、それでも勉強する必要はあると思う? #ポエム - Qiita
AI の答えを「答え」ではなく「最初の仮説」と考えると、何が変わる? #ポエム - Qiita
AI が 3 秒で答えると、自分の能力が小さく感じるのはなぜだと思う? #ポエム - Qiita
なぜ私たちは「速く流暢に答える人 = 頭がいい」と感じるんだろう? #ポエム - Qiita
AI に「それ本当?」と言えるようになるには、何が必要だと思う? #ポエム - Qiita
AI を鵜呑みにしないためには、どのくらい自分にも知識が必要? #ポエム - Qiita
AI と「議論する」って、どういうことだと思う? #ポエム - Qiita
AI にわざと反対意見を言わせると、何が見えてくる? #ポエム - Qiita
AI に「この回答の前提は?」と聞くと、何が分かる? #ポエム - Qiita
AI の答えを短期・長期で考え直すと、結論は変わる? #ポエム - Qiita
AI に「この案で困る人は?」と聞くと、何が見えてくる? #ポエム - Qiita
AI の答えが正しくても、採用しないほうがいいことはある? #ポエム - Qiita
AI 時代になって、勉強はむしろ難しくなったと思う? #ポエム - Qiita
「分かった」と「分かった気がする」は、どうやって見分ければいい? #初心者 - Qiita
AI に説明してもらったあと、自分では何を確認すればいい? #ポエム - Qiita
AI より詳しくなくても、AI の回答を疑うことはできる? #ポエム - Qiita
AI には「答え」と「論点」のどちらを出してもらうほうが役に立つ? #ポエム - Qiita
AI との壁打ちで、100 点の答えを目指す必要はある? #ポエム - Qiita
AI を使うほど、一次情報を読むことが重要になると思う? #ポエム - Qiita
「AI と人間、どちらが賢い?」という問いには意味があると思う? #ポエム - Qiita
「知っている」と「使える」の間には、何があると思う? #ポエム - Qiita
公式ドキュメントを読む力って、どうすれば身につく? #ポエム - Qiita
検索が上手い人は、何が違うと思う? #ポエム - Qiita
エラー メッセージをちゃんと読むって、意外と難しくない? #ポエム - Qiita
ログに「書いていないこと」まで考える必要はある? #ポエム - Qiita
Timeout を見て「ネットワーク障害だ」と決めつけないためには、どう考えればいい? #ポエム - Qiita
「事実」「仮説」「結論」は、どうやって分ければいい? #ポエム - Qiita
障害調査は「犯人探し」ではなく「仮説検証」だと思う? #ポエム - Qiita
「再現できない」という事象を、どう扱えばいいと思う? #ポエム - Qiita
なぜ一次情報まで戻って確認する必要がある? #ポエム - Qiita
技術用語は、いつ使って、いつ使わないほうがいい? #ポエム - Qiita
正確さを失わずに簡単に説明するには、どうすればいい? #初心者 - Qiita
例え話は、どんなときに説明をかえって分かりにくくする? #ポエム - Qiita
なぜ図を一枚描くだけで、話が通じることがあるんだろう? #ポエム - Qiita
技術の話をしたあと「つまり何?」に答えられる? #ポエム - Qiita
初心者に説明すると、自分の理解の穴が見えるのはなぜ? #ポエム - Qiita
人に教えると、自分が分かっていないことに気づくのはなぜ? #ポエム - Qiita
質問されたとき、すぐ答えないほうがいいのはどんなとき? #ポエム - Qiita
「ここまでは分かる。でもここからは分からない」と言える? #初心者 - Qiita
技術的な調べ物は、どこで「十分」と判断すればいい? #ポエム - Qiita
人間関係も障害解析のように「事実」と「仮説」を分けて考えられる? #ポエム - Qiita
人間関係で「事実」と「私の解釈」を分けるには、どうすればいい? #ポエム - Qiita
人格ではなく「今回の行動」だけを見ることはできる? #ポエム - Qiita
苦手な人について、あえて反証を一個探すと何が変わる? #ポエム - Qiita
「相手から見えている世界」を想像すると、何が変わると思う? #AI - Qiita
苦手な人を、無理に好きになる必要はある? #ポエム - Qiita
職場の人間関係を「まあ、どうでもいいか」と思えるようになるには? #ポエム - Qiita