メインコンテンツへスキップ
見出し画像

仕様を説明するより速い 失敗するテストを1本書いてから頼む開発フロー

    【400字の仕様書を書いても伝わらなかった】

    金額計算のロジックを直してもらうとき、私は丁寧に説明した。「税込表示で、端数は切り捨て、ただしクーポン適用後の金額に対して計算して、送料は課税対象外で……」。400字くらい書いた。返ってきたコードは、クーポンと税の順序が逆だった。もう一度説明した。今度は送料が課税されていた。

    3往復目で嫌になって、テストを書いた。

    【たった6行で終わった】

    it('クーポン適用後の金額に課税し、端数は切り捨てる', () => {

    expect(calcTotal({ price: 1000, coupon: 300, shipping: 500 }))

    .toBe(1270) // (1000-300)*1.1 = 770 → 770+500

    })

    これを渡して「このテストが通るように直して」と頼んだら、一発で通った。400字の日本語より、6行のコードのほうが正確だった。当たり前といえば当たり前で、日本語は解釈の余地があるが、期待値の数字には余地がない。

    【この順番が効く理由】

    自然言語の仕様は、書き手の頭の中では一意でも、読み手には複数の解釈が生まれる。しかもAIは分からないところを聞き返さずに、それらしく埋める。テストは「入力Xに対して出力はYである」という契約なので、埋めようがない。しかも通ったかどうかを機械が判定してくれるから、私が目視でレビューする必要すらない。

    【手順は3ステップ】

    1. 期待する挙動を、まず自分でテストとして1〜3本書く。実装がないので当然落ちる

    2. 「このテストを通してください。テストファイルは編集しないでください」と伝える

    3. 通ったら、境界値のテストを足してもう一度回す

    2番の「テストファイルは編集しないで」は必須。これを書かないと、実装ではなく期待値のほうを書き換えて緑にしてくることがある。私は一度、toBe(1270) が toBe(1330) に変わっているのに気づかずマージしかけた。

    【テストを書くのが面倒なときの抜け道】

    そもそもテスト環境がない、書き方が分からない、という場合もある。そのときは先にこう頼む。

    「calcTotal のテストを書きたい。vitest の設定と、空のテストファイルの雛形だけ作って。テストの中身は自分で書く」

    環境構築はAIが得意な領域なので任せて、期待値だけ自分で埋める。ここを人間が握るのが肝で、期待値まで書かせると「AIが考えた仕様をAIが実装する」だけになり、意味が半減する。

    【副産物として残るもの】

    このやり方をしていると、機能を1つ作るごとにテストが増える。半年やって、リグレッションで慌てることが目に見えて減った。AIに大きなリファクタを頼むときも、テストが緑なら安心して任せられる。テストを書くコストは、AIに任せられる範囲を広げるための投資として回収できる。

    【次の一歩】

    今おかしいと感じている関数を1つ選んで、「こうなってほしい」を1行のexpectで書いてみる。数字が思いつかないなら、その時点で仕様が固まっていない。それはAIの問題ではなく、こちらの問題で、気づけただけで十分に前進している。

    あなたへのおすすめ