HN 日本語サマリー

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

あなたは手動でGitコマンドを入力するからといって、より優れたエンジニアではありません

You're Not a Better Engineer Because You Type Git Commands by Hand (minid.net)

3 pointsby meerita0 コメント

要約

この記事は、27年間コードを書いてきた筆者が、AIエージェントを活用することで、コミットメッセージ、プルリクエストの説明、コードコメント、命名規則、Gitの管理といった、これまでエンジニアが時間を費やしてきた煩雑で退屈なタスクから解放された経験を語っています。AIはこれらのタスクを一貫してこなし、エンジニアは本来のアプリケーション開発に集中できるようになり、コスト削減と生産性向上に繋がると主張しています。

全文翻訳

手作業でGitコマンドを打つからといって、より優れたエンジニアになれるわけではない

27年間コードを書いてきた経験から、私は長年続いてきた小さくも苦痛なエンジニアリングタスクのリストに時間を費やすことをやめました。AIエージェントは今や、コミットメッセージ、プルリクエストの説明、コードコメント、命名規則、Gitの衛生管理、課題追跡、リリースワークフローなどを、ほとんどのチームが手作業で管理していた時よりも一貫性を持って処理してくれます。

しばらくお付き合いください。AIに関するもう一つの意見がありますが、まだ私を殺さないでください。

私がAIを気に入っている点の一つは、予想外にも高く評価していることです。それは、開発者がめったに楽しんでやらないタスク、そしてそれを適切に行うと、ばかげたほどの時間を消費するタスクにおいて、驚くほど優れているということです。

皆の忘れられた友人であるコミットメッセージから始めましょう。

良いコミットメッセージ、有用なPRの説明、そして変更を他者が理解できるようにするための周辺のコンテキストを書くのに、いくら時間を費やしたか思い出せません。私が一緒に仕事をしたほとんどのエンジニアは、意味のあるコミットメッセージをほとんど書きませんでした。そして、レビューやマージの時期になると、コミットやPRが何をしようとしていたのかを理解するために、コードを掘り下げるのにさらに多くの時間を費やしました。

今、私はその作業をAIに委任しています。

AIは、私が望むようにコミットメッセージやPRの説明を書いてくれます。その精度は、最初は少し怖いくらいでしたが、今では完全に気に入っています。私は、開発者がコーヒーを飲みながら一度だけ目を通すかもしれない短い文章を書く代わりに、アプリケーションに集中できます。

これはコミットやPRだけにとどまりません。コード内のコメントにも適用されます。この件については、明確な二極化があります。一部のエンジニアはコード内の良いコメントを好みます(例えば私です)が、他のエンジニアはリポジトリからすべてのコメントを喜んで削除するでしょう。正直に言って、両方の立場を理解できます。長年、私はバランスを見つけてきました。コードベース全体を人間が読める英語で書き直して、コードがすでに言っていることを繰り返すようなことはしたくありません。しかし、コメントには特定のルールがあります。絵文字を使わない、装飾的な無意味なものを避ける、作業している言語に適したコメント、一貫したフォーマット、適切なファイルヘッダー、LLMのコンテキストに有用な場合は完全なファイルパス、一行の事実に基づいた説明、ファイルが属するアーキテクチャレイヤーの情報などです。

これらの詳細を手作業で維持するために、何百時間も費やしたことを覚えています。そして、ああ、何か変更があるたびに、ヘッダーやコメントも変更しなければなりませんでした。今ではそのほとんどが自動化されています。リポジトリは適切に説明されたままになり、有用だが非常に反復的な詳細を維持するために脳細胞を注ぎ込む必要がなくなりました。私を責めないでください。長年、コードベースにこれほど気を配ることがプロフェッショナルな仕事の一部だと考えていました。現実はその考えに冷水を浴びせ続けました。ほとんど誰も気にかけず、そのような仕事をする数人を除いては。

皮肉なことに、その構造を最も高く評価するオーディエンスは、今やLLMです。

彼らはこのコンテキストを愛しています。以前私が書いたルール、コメント、パス、意図、アーキテクチャの説明を利用できます。これにより、エージェントとの作業がはるかに快適になります。以下のようなやり取りが得られます。

あなたはこのルールを書きましたが、今、私に反対のことを求めています。どのように調整しましょうか?

そのようなやり取りは、AI支援のエンジニアリングプロセスをはるかにスムーズにします。リポジトリはソースファイルの山ではなくなり、エージェントが一貫性に疑問を投げかけるのに十分な明示的な意図を持つようになります。

名前を付けることは依然として難しいので、私はすべてを手作業で行うのをやめました

かつて私が途方もない時間を費やしていたもう一つのタスクは、ファイル、クラス、関数、モジュール、およびそれらに関連するすべてのものに名前を付けることでした。私は、一緒に仕事をしたチームのために数十もの開発者ガイドを書きました。命名規則、ディレクトリ構造、接尾辞、接頭辞、抽象化、規則からの例外、そして最終的には例外からの例外。AIはこの仕事をより良くこなします。 プロジェクトが1年経っても30〜40種類のファイル命名スタイルがなくなることはありません。命名の競合も減ります。6ヶ月前に緊急チェックを担当していたファイルの呼び名を思い出そうと10分費やすこともなくなります。一貫して名前が付けられるようになります。

考えを変えることさえ、ほとんど無関係になります。私は次のように言うことができます。

class PostgreSQLClient {} を使用しないでください。class DatabaseClient {} のような汎用的な名前を使用してください。

するとエージェントはリファクタリングを実行し、参照を更新し、テストを実行し、不足している部分を修正し、チケットの関連チェックボックスをマークできます。考えを変えることはかつてはコストがかかりました。今では、多くの変更において、それはほとんど指示にすぎません。

Gitの監視もやめました

Gitも、エージェントに退屈な作業を任せて喜んでいる分野です。私はもう、百回目と同じ愚かな間違いを犯すことはありません。dev、main、または無関係なフィーチャーブランチで作業を開始してしまうことです。これは常に起こっていました。PRをマージし、後でローカル環境に戻ってコードを変更し始め、リモートで削除されたばかりのマージ済みブランチにまだいることに気づくのです。

今、エージェントがこれをチェックしてくれます。

あなたは dev ブランチにいます。適切なブランチを作成し、そこで作業を続行します。

良い。どうぞ。

そして、ブランチの作成だけで終わりません。私のワークフローでは、エージェントは [WIP] 付きのPRを準備し、適切なラベルを適用し、PRを割り当て、意味のある説明を書き、チェックボックスを追加し、タスクが完了して変更がプッシュされるにつれてそれらのチェックボックスを更新できます。GitHub Issueを作成し、それを適切なプロジェクト列に移動し、IssueをPRにリンクし、ラベルを適用し、説明を書くことができます。私はそのほとんどを考える必要がなくなりました。実際の problemas の良い解決策を見つけることに注意を集中できます。

デリバリーは儀式ではなく、一連のチェックになりつつあります

デリバリーの時期が来ても、同じことが起こります。

まず、/definition-of-done スキルを呼び出します。これは、実装がPRと計画で述べられたことをカバーしているかを確認します。テストや私が気にかけている他の検証をチェックします。何か異常、破損、または欠落しているように見える場合は通知してくれます。すべてが良好に見える場合、別のスキル /pr-check-release を呼び出します。これはリモートPRをチェックし、ラベルを更新し、[WIP] を削除し、[RFC] を追加し、説明を更新し、レビューのために変更を準備します。もし1日経ってもチームの誰もPRをレビューしなければ、それをマージします。エージェントは私にその条件を追跡してくれるので、/pr-merge-dev を実行でき、プロセスを処理してくれます。PRをマージし、リモートブランチを削除し、ローカルブランチを削除し、dev をクリーンな状態にプルバックします。これらのステップのどれも特に難しいものではありません。それがまさにポイントです。

小さなタスクは、何千もあるために高価なのです

HN追記: タイトルは意図的に少し挑発的にしました。これはすべてのエンジニアやすべてのワークフローに対する判断ではありません。私が手動で行うのをやめた仕事についての個人的な体験談です。

この膨大なコレクションの小さく苦痛なタスクを自分でやる必要がなくなったことによる解放感は、非常に価値があります。非常に。未だに、Gitコマンドを手でタイプすること、すべてのPRの説明を手書きすること、あるいはコミットメッセージを作成するために自分の指で注意深くキーボードを叩くことが、自分を他の人より上に引き上げる一種の技術だと信じているエンジニアがいます。彼らは、これらの儀式にどれだけのお金が消えているか全く分かっていないと思います。数分ではありません。数時間です。すべてのエンジニア、すべてのプルリクエスト、すべてのリリース、すべてのブランチの間違い、忘れられたチェックボックス、古い説明、命名に関する議論、正しくリンクされなかったすべての課題、時代遅れになったコメント、誰かが覚えていなければならなかったリポジトリのハウスキーピングのすべてのビットにわたって繰り返されます。

私は今でも、それらすべてを気にしています。おそらくほとんどの人よりも。違いは、結果がプロフェッショナルな仕事と見なされるために、すべての機械的なステップを自分で実行する必要があるとはもはや信じていないことです。

2026年、もしあなたがこの種のエンジニアリングのオーバーヘッドをAIに委任していないなら、私の意見では、あなたはお金を燃やしています。 そして、さらに重要なことに、あなたの人生を燃やしています。

HN追記 2:

HNでのコメントの反応を読んで、いくつか明確化します。

私が作っていないポイントに対して反論している人もいると思います。私は、「裏側で」物事がどのように機能するかを学ぶことが時間の無駄だったとは言っていません。その知識こそが、私が安全に自動化し、結果を検査し、自動化が間違っていることを認識することを可能にするのです。 当時、私が少年だった頃、SSHやFTPでファイルをアップロードすることから始め、スクリプトを書き、最終的にCI/CDを使用しました。それらのどれも、サーバー、権限、ネットワーク、障害、またはロールバックに関する私の理解を無用にはしませんでした。AIとGitは私にとって同じ進歩のように感じます。私は反復的な実行を自動化しているのであって、理解や責任を外部委託しているのではありません。

一つの批判は完全に公平でした。クラス名の変更例で、IDEがすでにF2でリファクタリングを実行できると指摘した人がいました。それは真実です、そしてそれ自体は最高の例ではありませんでした。私のポイントは、AIがシンボルリネーミングを発明したということではありません。有用な部分は、エージェントが要求された命名決定を理解し、必要に応じてシンボルと関連ファイルをリネームし、パッケージをまたぐ参照を更新し、テストとドキュメントを調整し、関連するチェックを実行し、リファクタリングが明らかにしたものを修正し、タスクまたはPRを更新できることです。F2はリファクタリング操作を実行します。エージェントは変更全体を検証済みの結果まで実行できます。

「思考」と見なされるものについて、一部のコメンターと意見が異なるのはここだと思います。git checkout -b を書くこと、実装が変更された後にPRの説明を更新すること、[WIP] を削除することを忘れないこと、または差分をコミットメッセージに要約することは、私のエンジニアリング価値が存在する場所ではないと考えています。私は依然としてシステムを理解し、アーキテクチャ上の決定を下し、悪い実装を却下し、差分をレビューし、障害モードについて推論し、出荷されるものに責任を取る必要があります。私がいくつかの機械的なステップを自分でタイプするのをやめたからといって、それらのどれも消えるわけではありません。それは思考を外部委託することとは大きく異なります。

そして、APIが利用できなくなったときに何をするかについてですが、私はStack Overflowが存在する前、Gitが存在する前、そして今日私が使用するほとんどのツールが存在する前にソフトウェアを書きました。APIの停止も生き残れると思います。