あなたの仕事は、動作することが証明されたコードを提供することです

あなたの仕事は、動作することが証明されたコードを提供することです

2025 年 12 月 18 日

ソフトウェア開発における AI 支援の価値に関するあらゆる議論の中で、私がいつも目にする憂鬱な逸話があります。それは、あるクラスの LLM ツールによって権限を与えられた若手エンジニアが、テストされていない巨大な PR を同僚 (つまりオープンソースのメンテナー) に預け、残りは「コード レビュー」プロセスが処理してくれることを期待しているということです。

これは失礼であり、他の人の時間の無駄であり、正直なところ、ソフトウェア開発者としての義務違反です。

あなたの仕事は、動作することが証明されたコードを提供することです。

ソフトウェア エンジニアとして、私たちは単にコードを作成するだけではありません。実際、最近では、それが LLM の目的であると主張する人もいるでしょう。配達する必要があります 機能するコード—そして、含める必要があります 証拠 それも機能するということ。それを行わないと、実際の作業の負担がコードをレビューする予定の人に直接移ることになります。

機能することを証明する方法

コードが機能することを証明するには 2 つの手順があります。どちらもオプションではありません。

1つ目は 手動テスト。コードが正しく動作するのを自分で見たことがなければ、そのコードは機能しません。もしそれがうまくいったとしても、それは正直なところ単なる偶然です。

手動テストのスキルは、開発する必要がある真のスキルです。システムを変更を示す初期状態にし、変更を実行して、それが望ましい効果があることを確認して実証できる必要があります。

可能であれば、これらの手順を一連のターミナル コマンドに減らし、出力とともにコード レビューのコメントに貼り付けることができます。ここにあります 最近の例。

一部の変更は実証するのが困難です。それらを実証するのがあなたの仕事です。画面キャプチャビデオを録画し、PR に追加します。加えた変更が実際に機能することをレビュー担当者に示します。

すべてが機能する幸せなパスをテストしたら、エッジケースを試し始めることができます。手動テストはスキルであり、壊れたものを見つけることは、上級エンジニアを定義するのに役立つスキルの次のレベルです。

変更が機能することを証明するための 2 番目のステップは、 自動テスト。 LLM ツールがあるので、これは非常に簡単です。つまり、このステップをスキップする言い訳はまったくありません。

あなたの貢献は、 小銭を同梱する 変更が機能することを証明する自動テストを使用します。実装を元に戻すと、そのテストは失敗するはずです。

テストを作成するプロセスは手動テストのプロセスを反映しています。つまり、システムを初期の既知の状態にし、変更を実行し、正しく動作したことを確認します。これを生産的に促進するためにテスト ハーネスを統合することも、投資する価値のある重要なスキルです。

自動テストですでにカバーされていると考えて、手動テストをスキップする誘惑に駆られることはありません。私もこれを自分で行うたびに、すぐに後悔してしまいます。

コーディングエージェントに最初に証明してもらいます

2025 年の LLM における最も重要なトレンドは、LLM の爆発的な成長です。 コーディングエージェント—Claude Code や Codex CLI などのツール。作業中のコードをアクティブに実行して、動作することを確認し、問題があればさらに反復処理できます。

これらのツールをマスターするには、そのツールを使用する方法を学ぶ必要があります。 変更が機能することを証明する 同じように。

これは、上で説明したプロセスとまったく同じです。変更が機能するときに手動でテストできる必要があり、変更が将来も機能し続けることを保証する自動テストを構築できる必要があります。

これらはロボットであるため、自動テストと手動テストは事実上同じものです。

ただし、彼らは少し違うように感じます。 CLI ツールに取り組んでいるときは、通常、Claude Code 自体の実行方法を教えて、最終的な自動テストでは Click の CLIRunner。

CSS の変更に取り組むとき、私はコーディング エージェントに、行った変更が期待どおりの効果をもたらしたかどうかを確認する必要があるときに、スクリーンショットを撮るように勧めることがよくあります。

自動テストの良い点は、コーディング エージェントがテストを作成するのにほとんど励ましを必要としないことです。プロジェクトにすでにテストがある場合、ほとんどのエージェントは、指示しなくてもそのテスト スイートを拡張します。また、既存のテストのパターンを再利用するため、テスト コードを適切に整理し、好みのパターンを追加しておくことは、エージェントが好みに合わせたテスト コードを構築するのに役立つ優れた方法です。

コードのテストに優れたセンスを養うことも、上級エンジニアを差別化するスキルの 1 つです。

人間が責任を負う

コンピュータは決して責任を負うことはできません。それが、現場にいる人間としてのあなたの仕事です。

ほとんどの人が LLM に 1,000 行のパッチを生成させ、コードレビューのために送信するように指示できます。それはもう価値がありません。価値あるものは貢献すること 動作することが証明されたコード。

次回 PR を送信するときは、それが正しく機能するという証拠を必ず含めてください。