HN 日本語サマリー

← 一覧へ戻る
プログラミング

巨大なプルリクエストを送るのをやめてほしい;愚痴

Stop sending me huge PRs; a rant (getsmall.xyz)

95 pointsby trezm60 コメント

要約

著者は、レビュー担当者にとって負担となる数千行に及ぶ巨大なプルリクエスト(PR)の送信に不満を表明しています。AIの進化は開発を加速させる一方で、コードの理解を困難にし、レビューの質を低下させるリスクがあると指摘しています。著者は、小さく、理解しやすく、レビューしやすいPRを推奨しています。

全文翻訳

巨大なプルリクエストを送るのをやめてほしい:愚痴

もう疲れたよ、ボス。1000行、2000行、3000行にも及ぶプルリクエスト(PR)のレビューにうんざりしている。なぜなら、あるエージェントが「問題を一度に片付けた」からだ。小さなPRが求められていなかったわけではない。それは書くのが簡単だからではなく、常にレビュー担当者の利益のためだった。AIは業界にとって素晴らしい恩恵だが、レビュー担当者やメンテナーにとっては大きな負担になりつつある。私がただ年老いた人間が雲に向かって叫んでいるだけなのかもしれないが、お願いだから、巨大なPRを送るのはやめてほしい。

最近、何度か「全体を変更しないと機能しない」とか「差分全体を入れないとコードは何も機能しない」という議論を聞いた。そうだろう? それでいいのか? 小さなPRのポイントは、必ずしも小さくて個別に完成された製品を持つことではない。それは、小さく、消化しやすく、レビュー可能で、理解可能な作業単位を持つことだ。これに関するデータはないので、勝手に推測するが、コードの断片を完全に理解するのにかかる時間は、コードがカバーする行数に比例して指数関数的に増加する。あなたが完全な機能をリリースしたかったからといって、私の時間を指数関数的に奪うことは、喜びをもたらさない。

ついでに言うと、50行ものコメントは必要ない。もちろん、関数を文書化し、jsdoc、rustdoc、javadocのようなものをすべて提供してほしい。それは素晴らしいことだ。しかし、「ログインしているかどうか」という変数がなぜ is_logged_in と名付けられたのかについて、5行のコメントを与えるのは絶対にやめてほしい。変数がうまく名付けられていれば、10回中9回はそれが何をするのか理解できるだろう。変数がうまく名付けられておらず、コメントが必要なら、変数をより良く名付けてほしい。

最後に、「AIを使ってそれを[理解](https://en.wikipedia.org/wiki/Grok)しろよ、兄弟」と言うAIマキシマリストたちへ。すでにAIによって作成されたコードを再処理するためにトークンを無駄にしている。「レビューには別のモデルを使っているよ」だって? それなら、なぜそもそも人間によるレビューのために提出したんだ? おそらく、我々のような取るに足らない人間がレビューする前に、君の大切なAIにそれを分離させ、我々がレビューした後で君がレビューするということもできるだろう?

いいか、AIは素晴らしいツールだ。本当に物事を速く進めるのを助け、コードをより良くすることができる。しかし、Reactが登場したとき、「Reactは書くのが速く、読みやすい」という理由で、より大きなPRを受け入れたわけではない。なぜ今、それをやっているんだ?

追記:巨大なPRを作って、私が途中で諦めて承認するのを期待しているのか? もしそうなら、見事だ。見事にやられた。