Visual Basic Advent Calendar 2025

📊連載第34回！初心者のためのExcel VBA入門：プロンプトで変わるコード品質！💡AI活用で保守性の高いVBAを自動生成🚀

Last updated at 2025-12-25Posted at 2025-11-06

Excel VBAにおけるAI活用によるコード生成の実装テクニック

私はVBAの活用経験を通じて得た知識を整理し、共有する目的で記事を作成しているプログラミング歴2年になるエンジニアです。前回は、シート表示制御の実装テクニックについて詳しく説明しました。今回は趣向を変えて、AIにVBAコードを作成してもらう際のプロンプト活用テクニックについて解説します。

はじめに

Excel VBAでアプリケーションを開発していると、複雑なコードを書く際にコーディング規約の統一や保守性の確保に悩むことがあります。特に、チーム開発や長期運用が前提のプロジェクトでは、一貫性のある高品質なコードを書き続けることは簡単ではありません。

近年、AI技術の進化により、ChatGPTやClaude、Geminiなどの生成AIを活用してコードを作成することが一般的になってきました。しかし、AIに単純に「このコードを改善して」と依頼しても、期待通りの結果が得られないことが多いのが現実です。

今回は、AIに対して明確な指示を与えることで、実務レベルの高品質なVBAコードを生成させるための専用プロンプトについて詳しく解説します。このプロンプトを活用することで、AIが生成するコードの品質を大幅に向上させ、実際の業務で長期運用できるコードを効率的に作成できるようになります。

AI活用におけるプロンプトの重要性

AIコード生成における一般的な問題点

AIにVBAコードの作成を依頼する際、多くの開発者が直面する問題があります。

よくある失敗パターン

命名規則がバラバラで統一感がない
エラー処理が不十分または不統一
コメントが不足している、または日本語と英語が混在
グローバル変数が乱用されている
パフォーマンスを考慮していない実装になっている

問題の本質
AIは指示がない場合、一般的なコーディングスタイルを採用します。しかし、それが必ずしも保守性・再利用性・パフォーマンスを重視した実務レベルのコードとは限りません。

明確なプロンプトによる解決

この問題を解決するために、詳細な指示を含む専用プロンプトを活用します。

プロンプトを使うことで実現できること

統一された命名規則（PascalCase、camelCase、定数の大文字など）
一貫したエラー処理（共通関数の利用）
適切なコメント（機能説明、引数・戻値の明記）
モジュール構成の統一（modMain、modUtilsなど）
パフォーマンス最適化（ToggleAppState、配列処理など）

プロンプトエンジニアリングとは

AIに対して適切な指示を与え、期待する出力を得るための技術を「プロンプトエンジニアリング」と呼びます。VBAコード生成においても、このプロンプトエンジニアリングの考え方が非常に重要になります。

VBAコード生成プロンプトの全体構成

プロンプトの基本構造

このプロンプトは、AIに対してVBAコードのブラッシュアップを依頼する際の完全な仕様書として機能します。

プロンプトの全体構成

セクション	内容	目的
目的	プロンプト全体の方針	AIの役割を明確化
基本原則	DRY、単一責任など	設計思想を指示
命名規則	PascalCase、camelCaseなど	コードの統一性
モジュール構成例	modMain、modUtilsの実装例	具体的な実装イメージ
エラー処理	統一的なエラー処理方法	保守性の向上
パフォーマンス最適化	ToggleAppState、配列処理など	実行速度の改善
設計ルール	定数化、禁止事項など	コード品質の確保
コメント規則	プロシージャ冒頭コメントなど	可読性の向上
最終チェックリスト	確認すべき項目一覧	品質保証

プロンプトの活用方法

基本的な使い方

このプロンプト全体をAI（ChatGPT、Claude、Geminiなど）にコピー＆ペースト
続けて、改善したいVBAコードを貼り付ける
AIが自動的に高品質なコードに変換

プロンプトの特徴

詳細な指示: AIが迷わないよう、具体例を豊富に含む
段階的な構成: 目的→原則→実装例の順で理解しやすい
実践的な内容: 実務で必要な要素を網羅

プロンプトの分量について

このプロンプトは非常に詳細で長文です。しかし、AIに対して明確な指示を与えるためには、この程度の詳細さが必要です。一度プロンプトを保存しておけば、繰り返し利用できるため、投資対効果は非常に高いと言えます。

プロンプトの各セクション詳細解説

目的と役割の定義

プロンプトの冒頭では、AIに対して明確な役割を与えます。

## 目的
提示されたVBAコードを、**保守性・再利用性・パフォーマンス・可読性**を最大化するようブラッシュアップしてください。

## あなたの役割
20年以上のキャリアを持つVBAプログラマーとして、実務で長期運用できる高品質なコードを作成してください。

このセクションの重要性

「エキスパート」としての役割を設定
単なるコード変換ではなく、品質を最大化するという明確な目標を設定
保守性・再利用性・パフォーマンス・可読性という4つの評価軸を明示

基本原則の明示

コード設計における基本的な考え方を指示します。

## 📋 基本原則
- **DRY原則**: 重複を排除し共通化
- **単一責任**: 1プロシージャ = 1機能
- **関心の分離**: データ処理・UI・I/Oを明確に分ける
- **早期リターン**: 異常系を先に処理しネストを減らす
- **Option Explicit** 必須
- **Call構文** で処理の流れを明示

各原則の意味

DRY原則（Don't Repeat Yourself）: 同じコードを何度も書かず、関数化して再利用
単一責任: 1つのプロシージャは1つの役割のみを持つ
関心の分離: データ取得、加工、表示を別々のプロシージャに分ける
早期リターン: エラーチェックを先に行い、正常系のネストを浅くする

命名規則の統一

コードの可読性を大きく左右する命名規則を詳細に指定します。

## 🏷️ 命名規則

| 対象 | 規則 | 例 |
|------|------|------|
| モジュール | PascalCase + 接頭辞 | `modMain`, `modUtils` |
| クラス | PascalCase + 接頭辞 | `clsTask`, `clsLogger` |
| プロシージャ | PascalCase（動詞始まり） | `GetData`, `UpdateSheet` |
| 変数 | camelCase | `rowCount`, `ws`, `rng` |
| 定数 | 大文字+アンダーバー | `MAX_ROW`, `COL_NAME` |
| Enum | `E_` + 日本語 | `E_処理状態`, `E_曜日` |
| Type | `T_` + PascalCase | `T_UserInfo`, `T_TaskItem` |

命名規則の効果

コードを見ただけで、それが変数なのか定数なのか判別できる
モジュールの役割が接頭辞から理解できる
プロジェクト全体で統一感が生まれる

モジュール構成の実装例

具体的なコード例を示すことで、AIに明確なイメージを与えます。

modMain（メイン処理）の例

Option Explicit

'==============================================================================
' 定数定義
'==============================================================================
Private Const SHEET_DATA As String = "データ"
Private Const MAX_ROW As Long = 10000

'==============================================================================
' メイン処理
'==============================================================================
Sub Main()
    On Error GoTo ErrHandler
    
    Call modUtils.ToggleAppState(False)
    Call Initialize
    Call ProcessData
    Call Finalize
    Call modUtils.ToggleAppState(True)
    
    Exit Sub
    
ErrHandler:
    Call modUtils.ToggleAppState(True)
    Call modUtils.HandleError("Main", Err.Number, Err.Description)
End Sub

modUtils（共通関数）の例

Sub ToggleAppState(ByVal enable As Boolean)
    With Application
        .ScreenUpdating = enable
        .EnableEvents = enable
        .Calculation = IIf(enable, xlCalculationAutomatic, xlCalculationManual)
    End With
End Sub

Sub HandleError(ByVal procName As String, ByVal errNum As Long, ByVal errMsg As String)
    Dim msg As String
    msg = "【エラー発生】" & vbCrLf & _
          "プロシージャ: " & procName & vbCrLf & _
          "エラー番号: " & errNum & vbCrLf & _
          "内容: " & errMsg
    
    Debug.Print "[" & Format(Now, "yyyy/mm/dd hh:nn:ss") & "] " & msg
    MsgBox msg, vbCritical, "エラー"
End Sub

実装例を含める理由

AIに対して「このような形式で書いてほしい」という具体的なイメージを伝える
抽象的な説明だけでなく、実際のコードを見せることで理解が深まる
共通関数の実装パターンを示すことで、AIが同様の構造を生成しやすくなる

エラー処理の統一

すべてのプロシージャで統一的なエラー処理を行うよう指示します。

Sub SampleProc()
    On Error GoTo ErrHandler
    
    ' メイン処理
    
    Exit Sub
    
ErrHandler:
    Call modUtils.HandleError("SampleProc", Err.Number, Err.Description)
End Sub

統一エラー処理の利点

エラーが発生した際、常に同じ形式でログ出力・メッセージ表示
デバッグが容易になる
エラー処理の漏れを防ぐ

パフォーマンス最適化の指示

実行速度を向上させるためのテクニックを明示します。

Application設定の制御

Call modUtils.ToggleAppState(False)
' 処理（画面更新なし・イベント無効・計算手動）
Call modUtils.ToggleAppState(True)

セルアクセスの最小化

Dim dataArr As Variant
dataArr = ws.Range("A1:C100").Value
' 配列で処理（高速）
ws.Range("A1:C100").Value = dataArr

パフォーマンス最適化の効果

画面更新を停止することで、処理速度が数倍～数十倍に向上
配列を使った一括処理により、セルアクセスの回数を削減
大量データを扱う場合に特に効果的

設計ルールと禁止事項

コード品質を確保するための具体的なルールを明示します。

定数化の徹底

Private Const SHEET_DATA As String = "データ"
Private Const COL_NAME As Long = 1
Private Const OUTPUT_PATH As String = "C:\Output\"

禁止事項

As Variant の乱用
型未指定の引数や戻り値

設計ルールの重要性

マジックナンバー（ハードコーディングされた数値や文字列）を排除
後から値を変更する際、定数を修正するだけで全体に反映される

コメント規則の詳細化

可読性を高めるためのコメント記述ルールを指示します。

プロシージャ冒頭コメント

'==============================================================================
' 【機能】データシートから条件に合致する行を抽出
' 【引数】wsSource: 元データシート, filterValue: 抽出条件
' 【戻値】なし
'==============================================================================
Sub ExtractData(ByVal wsSource As Worksheet, ByVal filterValue As String)

コメントの書き方

「なぜ」その処理を行うかを説明
自然で分かりやすい日本語を使用

' データが空の場合は処理をスキップ（エラー防止のため）
If lastRow < 2 Then Exit Sub

' 配列で一括読み込み（高速化のため）
Dim dataArr As Variant
dataArr = ws.Range("A2:C" & lastRow).Value

適切なコメントの効果

数ヶ月後に自分がコードを見返しても理解できる
チームメンバーがコードを理解しやすくなる
メンテナンス性が大幅に向上

最終チェックリストの活用

AIが生成したコードが要件を満たしているか確認するための項目です。

## ✅ 最終チェックリスト

* [ ] `Option Explicit` がある
* [ ] 型を明示している
* [ ] 定数化（マジックナンバー排除）
* [ ] 統一エラー処理（`modUtils.HandleError`）
* [ ] プロシージャ冒頭にコメント
* [ ] `Call` 構文を使用
* [ ] 共通関数は `modUtils` に配置
* [ ] パフォーマンス最適化（`ToggleAppState`）
* [ ] 外部依存コメントを明示

チェックリストの役割

AIが生成したコードの品質を保証
人間が最終確認する際の指標になる
コードレビューの基準として活用できる

実際の活用例とベストプラクティス

プロンプトの使用手順

ステップ1: プロンプトの準備

提供されたプロンプト全体をテキストエディタにコピー
必要に応じて、プロジェクト固有のルール（会社のコーディング規約など）を追記
保存しておき、繰り返し利用できるようにする

ステップ2: AIへの指示

ChatGPT、Claude、Geminiなどのチャット画面を開く
プロンプト全体を貼り付け
改善したいVBAコードを続けて貼り付け
送信

ステップ3: 生成されたコードの確認

AIが生成したコードを確認
最終チェックリストに基づいて品質を検証
必要に応じて追加の修正を依頼

具体的な活用シーン

シーン1: 既存コードのリファクタリング
長年使われてきた古いVBAコードを、現代的な設計思想に基づいてブラッシュアップする際に活用できます。

シーン2: 新規開発のコードレビュー
自分で書いたコードをAIに投げて、改善点を見つけてもらうことができます。

シーン3: チーム開発のコーディング規約統一
チームメンバーが書いたコードを、統一されたスタイルに自動変換する際に活用できます。

プロンプトのカスタマイズ方法

このプロンプトは、プロジェクトの要件に応じてカスタマイズすることができます。

カスタマイズのポイント

会社独自のコーディング規約を追加
特定のライブラリの使用指示を追記
プロジェクト固有の命名規則を反映
禁止事項や推奨事項を追加

カスタマイズ例

## プロジェクト固有ルール
- 設定ファイルはJSONフォーマットで保存
- ログ出力は専用のログファイルに記録

プロンプトの進化

このプロンプトは一度作成したら終わりではありません。実際に使用していく中で、不足している指示や改善点が見つかったら、随時追記していくことで、より精度の高いコード生成が可能になります。

AIツールの選択と特性

主要なAIツールの特徴

AIツール	特徴	VBAコード生成の精度
ChatGPT	汎用性が高く、長文のプロンプトに強い	高精度
Claude	コーディングに特化した性能	非常に高精度
Gemini	GoogleのAI、マルチモーダル対応	高精度

ツール選択のポイント

Claude: 特にコード生成に優れているため、VBAコード作成に推奨
ChatGPT: 日本語のニュアンスを理解しやすい
Gemini: 解説力は高いが、コードの安定性に課題

トラブルシューティング

問題1: AIが指示通りに動作しない

プロンプトを分割して送信してみる
より具体的な例を追加する
AIに「プロンプトを理解したか確認してください」と尋ねる

問題2: 生成されたコードが長すぎる

「コードを簡潔にしてください」と追加指示
必要な機能だけに絞って依頼

問題3: エラーが含まれるコードが生成される

「生成されたコードにエラーがないか確認してください」と依頼
具体的なエラー内容を伝えて修正を依頼

AIは完璧ではない

AIが生成したコードは非常に高品質ですが、完璧ではありません。必ず人間がレビューし、プロジェクトの要件に合致しているか、論理的なエラーがないかを確認することが重要です。AIはあくまで開発を支援するツールであり、最終的な責任は開発者にあることを忘れないでください。

今後の展望と発展性

AIとVBA開発の未来
AI技術は日々進化しており、今後さらに高精度なコード生成が可能になると予想されます。このプロンプトも、AIの進化に合わせて継続的に改善していくことで、より強力な開発支援ツールとして活用できるでしょう。

学習効果の期待
このプロンプトを繰り返し使用することで、プロンプトに含まれる設計原則やベストプラクティスが自然と身につき、開発者自身のスキル向上にも繋がります。AIが生成したコードを読み解くことで、「なぜこのような実装になっているのか」を理解し、VBA プログラミングの深い知識を習得できます。

実務での活用における注意点

プロンプトの管理方法

プロンプトをバージョン管理システム（Git など）で管理
チームメンバー間で共有し、統一されたコード品質を確保
定期的にプロンプトをレビューし、改善点を反映

セキュリティへの配慮

機密情報を含むコードをAI に送信する際は、事前に情報を削除または置き換える
会社のセキュリティポリシーを確認し、AI ツールの使用が許可されているか確認
生成されたコードに外部依存ライブラリが含まれる場合、ライセンスを確認

コストとリターンのバランス

AI ツールの利用料金とコード品質向上のメリットを比較
無料プランでも十分な品質が得られる場合が多い
大規模プロジェクトでは有料プランの検討も価値がある

本プロンプトの全文

以下が、今回解説したVBA コードブラッシュアップ用プロンプトの全文です。このプロンプトをコピーして、AI ツールで活用してください。

# VBAコード ブラッシュアップ指示書

## 目的
提示されたVBAコードを、**保守性・再利用性・パフォーマンス・可読性**を最大化するようブラッシュアップしてください。  
出力はブラッシュアップ後の**完全な修正版コード**として提示すること。  
元の構造や意図を理解した上で、改善を行うこと。

## あなたの役割
20年以上のキャリアを持つVBAプログラマーとして、実務で長期運用できる高品質なコードを作成してください。

## 📋 基本原則
- **DRY原則**: 重複を排除し共通化
- **単一責任**: 1プロシージャ = 1機能
- **関心の分離**: データ処理・UI・I/Oを明確に分ける
- **早期リターン**: 異常系を先に処理しネストを減らす
- **Option Explicit** 必須
- **Call構文** で処理の流れを明示
- **特別な理由がない限り、参照設定を行うコードを出力**

## 🏷️ 命名規則

| 対象 | 規則 | 例 |
|------|------|------|
| モジュール | PascalCase + 接頭辞 | `modMain`, `modUtils` |
| クラス | PascalCase + 接頭辞 | `clsTask`, `clsLogger` |
| プロシージャ | PascalCase（動詞始まり） | `GetData`, `UpdateSheet` |
| 変数 | camelCase | `rowCount`, `ws`, `rng` |
| 定数 | 大文字+アンダーバー | `MAX_ROW`, `COL_NAME` |
| Enum | `E_` + 日本語 | `E_処理状態`, `E_曜日` |
| Type | `T_` + PascalCase | `T_UserInfo`, `T_TaskItem` |

**注**:  
- ループカウンタは `i`, `j` など簡潔でOK  
- Enum以外で日本語変数名は禁止  
- **Typeは構造体として関連情報をまとめる場合のみ使用可**

## 🏗️ モジュール構成例

### modMain（メイン処理）
    ```vb
    Option Explicit
    
    '==============================================================================
    ' 定数定義
    '==============================================================================
    Private Const SHEET_DATA As String = "データ"
    Private Const MAX_ROW As Long = 10000
    
    '==============================================================================
    ' Enum / Type定義
    '==============================================================================
    Enum E_処理状態
        未処理 = 0
        完了 = 1
        エラー = 9
    End Enum
    
    '==============================================================================
    ' メイン処理
    '==============================================================================
    Sub Main()
        On Error GoTo ErrHandler
        
        Call modUtils.ToggleAppState(False)
        Call Initialize
        Call ProcessData
        Call Finalize
        Call modUtils.ToggleAppState(True)
        
        Exit Sub
        
    ErrHandler:
        Call modUtils.ToggleAppState(True)
        Call modUtils.HandleError("Main", Err.Number, Err.Description)
    End Sub
    ```

### modUtils（共通関数）

    ```vb
    Option Explicit
    
    '==============================================================================
    ' Application設定制御
    '==============================================================================
    Sub ToggleAppState(ByVal enable As Boolean)
        ' True: 通常状態, False: 処理高速化モード
        With Application
            .ScreenUpdating = enable
            .EnableEvents = enable
            .Calculation = IIf(enable, xlCalculationAutomatic, xlCalculationManual)
        End With
    End Sub
    
    '==============================================================================
    ' 統一エラー処理
    '==============================================================================
    Sub HandleError(ByVal procName As String, ByVal errNum As Long, ByVal errMsg As String)
        Dim msg As String
        msg = "【エラー発生】" & vbCrLf & _
              "プロシージャ: " & procName & vbCrLf & _
              "エラー番号: " & errNum & vbCrLf & _
              "内容: " & errMsg
        
        Debug.Print "[" & Format(Now, "yyyy/mm/dd hh:nn:ss") & "] " & msg
        MsgBox msg, vbCritical, "エラー"
    End Sub
    
    '==============================================================================
    ' ログ出力
    '==============================================================================
    Sub WriteLog(ByVal msg As String)
        Debug.Print "[" & Format(Now, "yyyy/mm/dd hh:nn:ss") & "] " & msg
    End Sub
    ```

## ⚙️ エラー処理の統一
全プロシージャで以下の形式を使用

    ```vb
    Sub SampleProc()
        On Error GoTo ErrHandler
        
        ' メイン処理
        
        Exit Sub
        
    ErrHandler:
        Call modUtils.HandleError("SampleProc", Err.Number, Err.Description)
    End Sub
    ```

* `Exit Sub/Function` を明示し、正常系とエラー処理を明確に分離すること

## ⚡ パフォーマンス最適化

### Application設定

ToggleAppState関数を使い、画面更新・イベント・再計算をまとめて制御する。
Falseで最適化モード（高速化）、Trueで通常状態に戻す。

    ```vb
    Call modUtils.ToggleAppState(False)
    ' 処理
    Call modUtils.ToggleAppState(True)
    ```

### セルアクセス最小化

    ```vb
    Dim dataArr As Variant
    dataArr = ws.Range("A1:C100").Value
    ' 処理...
    ws.Range("A1:C100").Value = dataArr
    ```

### With構文

    ```vb
    With ws.Range("A1:C10")
        .Font.Bold = True
        .Interior.Color = RGB(255, 255, 0)
    End With
    ```

## 🛠️ 設計ルール

### 定数化の徹底

    ```vb
    Private Const SHEET_DATA As String = "データ"
    Private Const COL_NAME As Long = 1
    Private Const OUTPUT_PATH As String = "C:\Output\"
    ```

### グローバル変数

* 原則禁止
* 引数の肥大化を避ける場合のみ限定的に使用（理由をコメントで明示）

    ```vb
    ' 複数関数で共有（引数の肥大化を防ぐため）
    Private wsTarget As Worksheet
    ```

### 禁止事項

* `As Variant` の乱用
* 型未指定の引数や戻り値

### 外部ライブラリ

    ```vb
    ' 【外部依存】Microsoft Scripting Runtime の参照設定が必要
    Dim dict As New Scripting.Dictionary
    ```

※特別な理由（Excel単体動作を優先する等）がない限り、参照設定を行う。
`CreateObject`による遅延バインディングは原則禁止。

## 📝 コメント規則

### プロシージャ冒頭コメント

    ```vb
    '==============================================================================
    ' 【機能】データシートから条件に合致する行を抽出
    ' 【引数】wsSource: 元データシート, filterValue: 抽出条件
    ' 【戻値】なし
    '==============================================================================
    Sub ExtractData(ByVal wsSource As Worksheet, ByVal filterValue As String)
    ```

### コメントの書き方

* 自然で分かりやすい日本語を使用（文末の句点不要）
* 「なぜ」その処理を行うかを説明
* 「どう対処するか」も補足（特に例外処理・データ補正箇所）
    
    ```vb
    ' データが空の場合は処理をスキップ（エラー防止のため）
    If lastRow < 2 Then Exit Sub
    
    ' 配列で一括読み込み（高速化のため）
    Dim dataArr As Variant
    dataArr = ws.Range("A2:C" & lastRow).Value
    ```

### レイアウト

* インデントは **4スペース**
* 処理の区切りには空行
* 複雑な条件式は中間変数で意味を明確化

## 📦 出力構成順序
    
    ```vb
    Option Explicit
    
    ' 【外部依存】必要な参照設定
    ' 定数定義
    ' Enum定義
    ' Type定義
    ' モジュールレベル変数（最小限）
    ' メイン処理（Call構文使用）
    ' 内部処理
    ```

共通関数（`ToggleAppState`, `HandleError`, `WriteLog` など）は `modUtils` にまとめる。

## ✅ 最終チェックリスト

* [ ] `Option Explicit` がある
* [ ] 型を明示している
* [ ] 定数化（マジックナンバー排除）
* [ ] 統一エラー処理（`modUtils.HandleError`）
* [ ] プロシージャ冒頭にコメント
* [ ] `Call` 構文を使用
* [ ] 共通関数は `modUtils` に配置
* [ ] パフォーマンス最適化（`ToggleAppState`）
* [ ] 外部依存コメントを明示（例: `'【外部依存】Microsoft Scripting Runtime の参照設定が必要`）

以上の指示に従い、下記のVBAコードをブラッシュアップしてください。

このプロンプトをAI ツールにコピー＆ペーストし、続けて改善したいVBA コードを貼り付けることで、高品質なコードを自動生成できます。

ゼロからのコード生成にも対応

このプロンプトは、既存コードの改善だけでなく、要件を伝えるだけで1からコードを生成することも可能です。プロンプトの冒頭と文末を少し修正するだけで、新規開発にも活用できます。

プロンプトの修正箇所

元のプロンプトの「目的」セクションと最後の指示文を以下のように変更します。

修正箇所①: 冒頭の「目的」セクション

## 目的
以下の要件に基づいて、**保守性・再利用性・パフォーマンス・可読性**を最大化したVBAコードを作成してください。  
出力は**完全な動作可能なコード**として提示すること。

## 要件
[ここに実現したい機能を具体的に記載]

修正箇所②: プロンプト文末の指示文

以上の指示に従い、上記要件を満たすVBAコードを作成してください。

ゼロから生成する場合の使用例

プロンプト全体をコピー
- 本記事で紹介したプロンプトをコピー
- 冒頭の「目的」セクションを修正箇所①の形式に変更
- 文末の指示文を修正箇所②の形式に変更

要件を具体的に記載

## 要件
- 「売上データ」シートから2025年10月のデータのみを抽出
- 売上金額が10万円以上のレコードに絞り込み
- 抽出結果を「分析結果」シートのA列から出力
- 処理実行前に確認ダイアログを表示
- 処理完了後に抽出件数を含むメッセージを表示

AIに送信
- 修正したプロンプトをAIツールに貼り付け
- AIが自動的に要件を満たすコードを生成

ゼロから生成する場合の注意点

ゼロからコードを生成する場合、以下の点に注意してください。

要件を具体的に記載する
- 曖昧な表現を避け、処理の流れを明確に指定
- シート名、列名、条件などを具体的に記載
- 「どのように動作してほしいか」を詳しく説明
段階的な開発を推奨
- 一度に複雑なコードを生成せず、まず基本機能から作成
- 動作確認後、追加機能を依頼して段階的に拡張
- この方法により、エラーの原因を特定しやすくなる
生成後の動作確認
- AIが生成したコードは必ずテスト実行
- エラーが発生した場合は、エラー内容をAIに伝えて修正を依頼
- データの整合性や期待通りの動作を確認

既存コード改善とゼロからの生成の使い分け

状況	推奨する使い方	プロンプト修正箇所
既存コードがある	改善モード	修正不要（元のプロンプトのまま）
新規開発	生成モード	冒頭の「目的」と文末の指示文を修正
機能追加	生成モード	既存コードを添えて要件を追加

このように、プロンプトの冒頭と文末を少し変更するだけで、リファクタリングから新規開発まで幅広く対応できます。AIを活用することで、開発時間を大幅に短縮し、より高品質なコードを効率的に作成できるようになります。

要件定義の重要性

ゼロからコードを生成する場合、要件の具体性が生成されるコードの品質を大きく左右します。曖昧な指示ではなく、「どのシートから」「どんな条件で」「どこに出力するか」を明確に伝えることで、AIはより精度の高いコードを生成できます。

まとめ

今回解説したAI活用によるコード生成の実装テクニックは、「統一されたコーディング規約を維持したい」「保守性の高い高品質なコードを効率的に作成したい」といった実務開発における課題を体系的かつ確実に解決する実用的な手法です。

この手法の核心となるのは、詳細な指示を含む専用プロンプトによる明確な仕様定義と、AIに対するエキスパートとしての役割設定による品質制御です。実装時に特に重要なのは、命名規則・モジュール構成・エラー処理の統一化と、プロンプトのカスタマイズによるプロジェクト固有要件への対応の徹底です。

単純な依頼では一貫性のないコードが生成されてしまう問題に対し、基本原則・命名規則・具体的な実装例を含む包括的なプロンプトで設計思想を明確に伝え、さらに最終チェックリストによる品質保証を組み込むことで、堅牢で実務レベルのコード生成を実現できます。

また、プロンプトの冒頭と文末を修正することで既存コードの改善だけでなくゼロからのコード生成にも対応でき、DRY原則・単一責任・パフォーマンス最適化といった設計原則を自然と学習できることで、他のプロジェクトでも容易に活用できる汎用的な開発支援ツールとして発展させることが可能です。

次回は、作成したマクロをアドイン化して全ブックで使用可能にする実装テクニックについて解説していきます！ぜひご期待ください！

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up