🔖

仕様駆動開発 × 生成AI活用で実装品質を高める方法

に公開
生成 AI
AI駆動開発
SDD
仕様駆動開発
idea

はじめに

AIによるコード生成が広く使われるようになり、

「プログラミングスキル」よりも
「何を作るかを明確に言語化する力」が重要になっています。

しかし多くのプロジェクトでは、

  • 仕様が曖昧
  • 実装がチームによってばらばら
  • 結果としてバグや認識ズレが発生

といった問題が起きています。

そこで有効なのが 仕様駆動開発（Specification-Driven Development）× AI活用 です。

この記事では、初心者でもわかるように、

  • 仕様駆動開発とは何か
  • なぜAIと相性が良いのか
  • 実務でどう使うか

を整理します。

そもそも、仕様駆動開発とは？

仕様駆動開発とは、

先に仕様（どう動くべきか）を明確に定義してから実装する開発手法

です。

これは単にドキュメントを書くという意味ではなく、

  • 入力と出力
  • 正常／異常系の挙動
  • APIのインターフェース
  • エラー時の挙動

を言葉と構造で明確に定義することを指します。

なぜ仕様を書くことが重要なのか？

曖昧な仕様で作ると必ず手戻りが起きます。

例えば、

  • 「ログイン機能を作る」だけでは十分ではありません
  • 「ログイン成功時になにを返すか？失敗時は何を返すか？」
  • 「パスワードが未入力だったらどうするか？」

といった項目が未定義のまま実装されます。

こうした仕様の抜け漏れが、あとで大きな手戻りにつながります。

仕様は「前提の共通認識を言語化する道具」です。

人と人であればハイコンテキストなやり取りも可能かもしれませんが、

AIには共通認識をしっかり言語化して伝えてあげることが重要です。

AIと仕様駆動開発の相性が良い理由

AIは、仕様が明示されていればいるほど、
生成されるコードの精度が上がります。

曖昧な仕様を与えると、

  • 一部しか対応できない
  • 想定外のエラー条件を無視する
  • 不十分なインターフェース設計になる

などの問題が起きます。

一方で仕様が明確なら、

  • 正常／異常系を実装
  • 型やレスポンス仕様に従う
  • テストコードまで生成

といった高品質な出力が得られます。

良い仕様の要素

良い仕様は次の4つの観点で構成されます。

① 入力

  • どの値を受け取るか
  • 型は何か
  • バリデーション条件は？

例：「emailは必須 / 形式チェックあり」

② 正常系

  • 成功時の挙動
  • 返却値の形式
  • 状態遷移

例：「ログイン成功 → JWTを返す」

③ 異常系

これが抜けがちです。

以下をすべて書きます。

  • エラーメッセージ
  • HTTPステータスコード
  • 発生条件

例：「パスワード未入力 → 400、’password required’ 」

④ 非機能要件

  • どのくらいの速度が必要か
  • 同時実行数
  • キャッシュ仕様
  • セキュリティ要件

これらも仕様の一部です。

仕様作成もAIで行う

ステップ①：要望＋整理指示をまとめてAIに渡す

例：

「ログイン機能を作成したいです。
　以下の観点で項目ごとに分けて整理してください」

- 入力
- 正常系
- 異常系
- レスポンス形式
- セキュリティ要件」

これをそのままAIに渡します。

ステップ②：レビューする

ここが重要です。

AIが出した仕様を、

  • 異常系は足りているか？
  • ステータスコードは適切か？
  • セキュリティ観点はあるか？

という観点で確認します。

仕様駆動 × AI 開発の具体手順

実際の開発での進め方は次の通りです。

ステップ①：要望＋整理指示をまとめてAIに渡す

例：

「ログイン機能を作成したいです。
　以下の観点で項目ごとに分けて整理してください」

- 入力
- 正常系
- 異常系
- レスポンス形式
- セキュリティ要件」

これをそのままAIに渡します。

ステップ②：レビューする

ここが重要です。

AIが出した仕様を、

  • 異常系は足りているか？
  • ステータスコードは適切か？
  • セキュリティ観点はあるか？

という観点で問題がないか確認します。

ステップ③：AIに実装を依頼する

仕様をそのままAIに渡します。

ステップ④：テストコードも生成する

テストコードが必要な場合は、AIにテスト生成も依頼します。

仕様があるので、異常系まで含めたテストが作りやすくなります。

ステップ⑤：実装レビュー

AIで生成したコードはそのまま使わずレビューします。

確認ポイント：

  • 正常／異常系は仕様どおりか？
  • セキュリティはクリアか？
  • 依存は適切か？（service, repository等）

補足

作成した仕様はあとあと確認できるように、残しておくことをおすすめします。

仕様駆動がもたらすメリット

仕様駆動 × AI活用で得られる価値は次の通りです。

① 手戻りが減る

曖昧な要件を実装前に整理することで、
後から修正が少なくなります。

② AIの精度が上がる

仕様をそのままAIに渡せるため、
生成コードの品質が高くなります。

③ 一貫性が担保される

チームメンバー全員が同じ仕様を参照できるため、
バラバラな実装になりません。

よくある失敗と回避

❌ 異常系を書かない

仕様を正しく書いていても、異常系を忘れると
AIも誤ったコードを出します。

→ 常に「エラー条件とステータス」を明記

❌ 仕様を曖昧にする

例：「エラー時は適切なレスポンス」

→ どんなerror？どんなstatus？

仕様は明確に書くこと

❌ AIに丸投げ

AIは万能ではありません。

仕様が良ければ精度は高いですが
間違いは必ずあります。

→ レビューを欠かさない

まとめ

AI時代の開発では、

仕様を書く力 ＝ 実装品質

になりつつあります。

仕様駆動開発は、
ただの書き方ではなく、品質を担保するための思考法です。

  • 仕様を書く
  • AIで実装する
  • テストを生成する
  • レビューする

このサイクルを意識するだけで、精度が大きく変わります!

Discussion