※本ページはプロモーション(広告)を含みます。

生成AI活用

生成AIでVBAやGASのコードを作成・エラー修正する手順と安全な指示の出し方

生成AIを使ってExcel VBAやGoogle Apps Script(GAS)のコードを正確に作成し、エラーを修正する実務手順を解説。精度の高いプロンプトの型、テスト・検算方法、機密情報を守るマスキングまで網羅します。

日々の定型業務を効率化するために、Excel VBA(マクロ)やGoogle Apps Script(GAS)を導入したいと考えつつも、専門的な文法やエラー対処への不安から着手をためらっている方は少なくありません。

近年の生成AIを活用すれば、コードを一から自力で書かなくても、日本語でやりたい処理を指示するだけで実務に使えるスクリプトを生成できます。しかし、プロンプト(指示文)が曖昧だと意図と異なるコードが出力されたり、実行時にエラーが発生して止まったり、本番データを予期せず書き換えてしまうリスクもあります。また、社内の機密データや個人情報をそのままAIに入力してしまうセキュリティ事故にも注意が必要です。

この記事では、生成AIを使ってVBAやGASのコードを正確に作成・修正するためのプロンプトの組み立て方、安全に動作確認と検算を行う手順、そしてエラー発生時にAIへ的確な修正指示を出す方法を具体的に解説します。

なお、一般的な事務作業におけるプロンプトの基本ルールは「ChatGPTなど生成AIで事務作業を効率化する方法」を、そもそもどのツールで自動化すべきかの全体像は「ノーコード自動化ツールの比較」や「Excelスキルの全体像と学ぶ順番」をご覧ください。また、GASの起動手順やトリガー設定の基礎は「GASでスプレッドシートの定型作業を自動化する手順」で詳しく扱っています。


生成AIによるVBA・GASコード作成の全体像

生成AIをプログラミングの支援役として実務に導入する場合、AIにすべてを任せるのではなく、人間とAIの役割分担を明確にしておく必要があります。

人間とAIの役割分担

生成AIは、膨大な公開コードや技術文書を学習しているため、一般的なアルゴリズムや定型的な処理の記述を得意とします。一方で、「社内のどのシートの、どの列に何が入っており、例外時にどう処理すべきか」という文脈は、指示者が正確に伝えない限り把握できません。

項目 人間が担当する役割 生成AIが担当する役割
要件定義 処理の目的、対象ファイル、開始条件・例外条件の整理 目的を達成するための処理フローの設計
コード記述 指示文の入力、必要なパラメータの調整 VBA構文やGAS(JavaScript)構文の出力
テストと検算 テスト環境の準備、実行結果の整合性確認 エラー原因の特定、代替コードの提案
リスク管理 機密情報の保護、実行権限の管理、バックアップ コメント文の記述、エラーハンドリングコードの提示

生成AIは「指示された条件を満たす、それらしいコード」を高速で組み立てます。そのコードが社内ルールの下で安全に動くか、データに破壊的な影響を与えないかを判断・検証するのは人間の役割です。


コード生成に適したプロンプトの設計技法

生成AIから実務でそのまま動くコードを引き出すには、プロンプトに含めるべき情報を構造化して伝える必要があります。プロンプト作成の基礎的な構文技法については「ChatGPTの回答精度を上げるプロンプト基本技法」でも解説していますが、コード生成においては特有の技術的前提を明記することが不可欠です。

精度を安定させるプロンプトの必須5要素

コード生成のプロンプトでは、以下の5つの要素を網羅します。1つでも欠けると、AIが勝手に前提を補完(ハルシネーション)し、実環境とずれたコードを出力する原因になります。

  1. 実行環境と対象ツール:言語(VBAまたはGAS)、動作環境(Windows版Excel 2021、Googleスプレッドシート等)
  2. 対象データの構造(入出力仕様):対象シート名、処理対象のセル範囲、見出し行の位置、最終行の取得方法
  3. 具体的な処理要件:処理の開始トリガー、データの判定基準、転記・加工のルール
  4. 制約条件・安全要件:既存データの上書き可否、エラーハンドリング(中断せずスキップ等)、元データの保護
  5. 出力形式の指定:コード本体に加え、コードの貼り付け先、設定が必要な変数の解説を求める

【実務例】Excel VBAの生成プロンプトテンプレート

実務で頻度の高い「条件に合致する行を別シートへ転記する」処理を例にしたプロンプトのテンプレートです。

# 命令
Excel VBAのコードを作成してください。

# 実行環境
- OS: Windows 11
- Excelバージョン: Microsoft 365(デスクトップ版)

# データの構造
- ブック構成: 同一ブック内
- 抽出元シート名: 「売上データ」
  - 1行目: 見出し(A列: 受注日, B列: 顧客名, C列: 金額, D列: ステータス)
  - データ開始: 2行目から(最終行は可変)
- 転記先シート名: 「未入金一覧」
  - 1行目: 抽出元と同じ見出しが設定済み
  - 転記開始: 2行目以降(実行前に対象範囲をクリアする)

# 処理条件
1. 「売上データ」シートのD列(ステータス)を確認する。
2. ステータスが「未入金」である行のA列〜D列をコピーし、「未入金一覧」シートの最終行の次の行へ順番に貼り付ける。
3. 転記処理の前に、「未入金一覧」シートのA2以降のデータ(見出し行を除く)を初期化(クリア)する。

# 制約条件
- シートが存在しない場合にエラーメッセージを表示して処理を安全に中断するエラー処理を含めてください。
- 画面更新の停止(ScreenUpdating = False)を入れ、処理速度を向上させてください。
- 各処理ブロックに日本語のコメントを付与してください。
- 初心者でも編集しやすいよう、シート名などの設定値はコード冒頭で定数(Const)として定義してください。

# 出力形式
- VBAコードのみをコードブロックで出力してください。
- コードの後に、VBE(Visual Basic Editor)のどのモジュール(標準モジュール等)に貼り付けるべきかを短く記載してください。

【実務例】Google Apps Script(GAS)の生成プロンプトテンプレート

Googleスプレッドシートから条件に合うデータを抽出し、Gmailで下書きを作成する処理を想定したテンプレートです。

# 命令
Google Apps Script(GAS)のスタンドアロンスクリプトまたはコンテナバインドスクリプト用のコードを作成してください。

# 実行環境
- Google Workspace(スプレッドシートおよびGmail)

# データの構造
- スプレッドシート名: バインドされている現在のアクティブシート
- 対象シート名: 「請求管理」
  - 1行目: 見出し(A列: 企業名, B列: 担当者名, C列: メールアドレス, D列: 支払期日, E列: 送信ステータス)
  - 2行目以降: データ行(最終行は可変)

# 処理条件
1. 「請求管理」シートを1行ずつループ処理する。
2. E列(送信ステータス)が空欄、かつD列(支払期日)が実行日より前(期日超過)の行を特定する。
3. 条件に合致した企業に対し、Gmailの下書き(Draft)を作成する。
   - 宛先: C列のアドレス
   - 件名: 【重要】お支払い期日のご確認(株式会社〇〇)
   - 本文: B列の担当者名を含めた督促用定型文
4. 下書き作成が成功したら、該当行のE列に「下書き作成済(実行日時)」を記入する。

# 制約条件
- メールは「送信」ではなく「下書き作成(createDraft)」にとどめてください(誤送信防止のため)。
- スプレッドシートへのアクセス回数を減らすため、データは一度配列に取得(getDataRange().getValues())してから処理してください。
- 実行権限の認証(OAuth)が必要な旨を注意書きとして添えてください。

曖昧さを排除するためのセル番地・シート名・処理条件の指定法

生成AIに指示を出す際、日常会話のような曖昧な表現を使うとコードの不具合につながります。以下の対比表を参考に、解釈の余地をなくした指定を心がけてください。

曖昧な指定(不具合の元) 正確な指定(推奨) 理由
「表のデータを集計して」 「A1セルからE列の最終行までの範囲を対象に、C列の数値を合計してE列の最下行に出力して」 データの開始位置、終了位置、出力先が確定するため
「先月のシートからコピーして」 「『2026年3月』という名前のシートのA2:D50をコピーして」 シート名が日付関数の動的生成か固定名かが明確になるため
「エラーが出たら飛ばして」 「行の処理中に例外が発生した場合は、その行の処理をスキップし、F列に『エラー』と書き込んで次の行へ進んで」 エラーハンドリングの構文(On Error Resume Nextやtry-catch)を適切に制御できるため
「データを消して入れ直す」 「見出し行(1行目)を残し、2行目から最終行までの値と書式をクリアした上で貼り付けて」 見出し行まで消去してしまうミスを防ぐため

セキュリティ上コード化してはいけないデータの取り扱い

業務自動化コードを生成AIに作成させる際、最も重大なインシデントになり得るのが「機密情報や個人情報のプロンプト入力」です。生成AIツールの運用管理や社内ルールについては「生成AIを仕事で使う前に知っておきたい5つのリスクと、社内ルールの作り方」でも取り上げていますが、スクリプト作成時には特有の漏洩ルートが存在します。

プロンプトに含めてはならない4種類のデータ

コード生成を依頼する際、実際の画面やデータをそのままAIへ貼り付けてはいけません。以下の情報はプロンプト入力時に除外するか、ダミーデータに置き換えます。

  1. 個人を特定できる情報:氏名、メールアドレス、電話番号、社員番号、マイナンバーなど
  2. 取引先・顧客の固有情報:顧客企業名、契約金額、口座番号、取引履歴
  3. 認証情報・アクセス権限情報:APIキー、アクセストークン、各種サービスのIDおよびパスワード
  4. 内部ネットワーク・機密パス:社内共有サーバーのIPアドレス、UNCパス(\\server\share\...)、社外秘フォルダ名

データを安全にマスキング・ダミー化する手順

データの構造をAIに把握させたい場合は、以下の手順で無害化してからプロンプトに貼り付けます。

  1. 実データのコピーを作成する:作業中のExcelファイルやスプレッドシートを別ファイルに複製します。原本は直接操作しません。
  2. 置換機能で一括ダミー化する:
    • 氏名:山田太郎、鈴木一郎 などの一般的な仮名、または 氏名A、氏名B に置換
    • 社名:クライアントA社、取引先B社 に置換
    • 金額:すべて 1000、50000 などの丸めた仮数値に置換
    • メールアドレス:user01@example.com などのテスト用ドメインに置換
  3. パス情報の一般化:
    • 実パス:\\tokyo-nas01\sales_dept\private\2026\file.xlsx
    • プロンプト用:C:\sample_folder\file.xlsx または [ネットワークパス] と記述し、コード生成後に手元で差し替える

APIキーや認証情報をスクリプト内に直書きさせない指示

GASやVBAで外部サービス(Slack、LINE、OpenAI API、社内基幹システム等)と連携するコードを作成する場合、プロンプト内で「APIキーを直接書き込まない設計」を指示します。

GASの場合:スクリプトプロパティの利用を指示する

# 指示条件
APIキーや連携URLは、コード内に直接文字列として記述(ハードコーディング)しないでください。
Google Apps Scriptの「スクリプトプロパティ(PropertiesService.getScriptProperties())」から取得する構造にしてください。
また、プロパティのキー名は「SLACK_WEBHOOK_URL」としてコードを書いてください。

VBAの場合:設定専用シートや外部設定ファイルの利用を指示する

# 指示条件
接続先のパスワードやトークンは、VBAコード内に直書きせず、非表示にした「Config」シートのB2セルから読み込む形式、または実行時に入力を求める「InputBox」形式にしてください。

これにより、作成されたコードをチーム内で共有したり、Git等のバージョン管理ツールにアップロードしたりした際の情報漏洩を防げます。


出力されたコードの動作確認と検算の手順

生成AIが出力したコードは、一見すると論理的に正しく見えても、実環境で予期せぬ挙動(無限ループ、全行削除、計算のズレ)を引き起こす可能性があります。動作確認は必ず段階を踏んで進めます。

本番環境で動かす前に行う3つの事前準備

コードを貼り付けて即座に実行することは厳禁です。以下の3点を必ず準備します。

【事前準備チェック】
□ 1. 対象ファイルのバックアップを取得したか(別名保存・世代管理)
□ 2. テスト用のデータ(5〜10行程度の軽量データ)を用意したか
□ 3. 画面描画の停止解除や、処理を強制終了するコマンドを把握しているか
      - VBA強制終了: [Ctrl] + [Break](または [Esc] 連打)
      - GAS強制終了: 実行ログ画面から「実行をキャンセル」

1ステップずつ動かすデバッグ・テスト実行の進め方

コードを検証する際は、最初から全体を一括実行せず、1行ずつ動作を確認(ステップ実行)します。

Excel VBAのデバッグ手順

  1. Excelで Alt + F11 を押し、Visual Basic Editor(VBE)を開く。
  2. 挿入メニューから「標準モジュール」を追加し、生成されたコードを貼り付ける。
  3. コード内のプロシージャ(Sub ...)の中にカーソルを置く。
  4. F8 キーを押す:押すたびにコードが1行ずつ黄色くハイライトされ、順番に実行されます。
  5. Excelシートの画面と並べて配置し、F8 を押すごとに想定通りのセルが選択・転記されているかを視覚的に確認します。
  6. ループ処理(For や Do While)に入ったら、変数の値が正しく加算されているか、終了条件でループを抜けるかを注視します。

GASのデバッグ手順

  1. スプレッドシートの「拡張機能」>「Apps Script」を開く。
  2. エディタにコードを貼り付け、保存アイコンをクリックする。
  3. 実行したい関数を選択し、行番号の左側をクリックしてブレークポイント(赤丸)を設定する。
  4. 「実行」ではなく「デバッグ」ボタンをクリックする。
  5. 処理がブレークポイントで一時停止するため、画面右側の「実行環境」パネルで変数の値を確認しながら、ステップオーバー(行送り)ボタンで1行ずつ進めます。
  6. Logger.log(変数名) を要所に追加し、取得したデータ配列の中身が空(null や undefined)になっていないかをログで確認します。

データの抜け漏れ・計算狂いを防ぐ「検算」チェックリスト

コードがエラーなく最後まで完走したとしても、処理結果が正しいとは限りません。以下のチェックリストに従って、結果を数値的に検算します。

検算項目 確認手順 よくある不具合原因
行数・件数の整合性 元データの該当件数と、出力先の行数が完全に一致しているか確認する。 最終行取得ロジック(End(xlUp).Row など)のオフセット設定ミス(+1の有無)。
合計値・集計値の一致 元データ側で手動フィルターをかけた合計値と、コードが出力した集計値を突合する。 不可視行(非表示セル)の巻き込み、条件判定の不等号(< と <=)の誤り。
データ型の保持 日付(yyyy/mm/dd)がシリアル値や文字列化して崩れていないか、数値の頭のゼロ(001 等)が消えていないか確認する。 値の代入時に書式設定(.NumberFormatLocal)が引き継がれていない。
境界値の挙動 条件の境界となる値(例: 0、上限値、空白セル、マイナス値)が正しく分類されているか確認する。 空白セルの判定漏れ("" と IsEmpty、null の差異)。

エラー発生時に生成AIを使って迅速に修正する手順

コードを実行してエラーが出た場合、自己流でコードを書き換えるよりも、エラー情報と状況を正確にAIへフィードバックする方が迅速に解決します。

エラーメッセージと発生箇所の正しい伝え方

AIに「動きませんでした。直してください」とだけ伝えても、適切な修正案は得られません。以下の4つの情報をセットで入力します。

【エラー報告プロンプトに含める4大情報】
1. 発生したエラーの完全なテキスト(エラー番号と説明文)
2. エラーが発生した行(黄色くハイライトされた行、またはログに表示された行番号)
3. エラー発生時点での主要な変数の値(行番号、対象セルの値など)
4. 試みた処理の文脈(どのシートのどの処理の最中だったか)

「動かない」を避ける追加指示のテンプレート

VBAでエラーが発生した場合のプロンプト例

先ほど出力してもらったExcel VBAのコードを実行したところ、実行時エラーが発生しました。修正版のコードを提示してください。

# エラー情報
- エラー番号: 実行時エラー '9'
- エラーメッセージ: インデックスが有効範囲にありません。
- 停止した行:
  Set wsTarget = ThisWorkbook.Sheets("未入金一覧")

# 現在の環境と状況
- ブック内のシート名を確認したところ、実際のシート名は「未入金_一覧」(アンダーバーあり)になっていました。

# 修正の要望
1. シート名定数を「未入金_一覧」に修正してください。
2. 万が一、指定したシート名が存在しない場合でも実行時エラーで止まらず、「対象シートが見つかりません: [シート名]」という警告メッセージを表示して処理を安全に終了(Exit Sub)させるエラー処理を追加してください。
3. 修正した箇所がわかるように解説を添えてください。

GASで実行制限や型エラーが発生した場合のプロンプト例

提示されたGASコードを実行したところ、以下のエラーログが出力されて停止しました。

# ログ内容
TypeError: Cannot read properties of undefined (reading '0')
at checkOverdue(コード:18:25)

# 該当箇所周辺のコード
const values = sheet.getRange(2, 1, lastRow, 5).getValues();
for (let i = 0; i <= values.length; i++) {
  if (values[i][3] < today) { // ← ここでエラー
    ...

# 修正の要望
- エラーの原因を解説した上で、修正した完全なコードを出力してください。
- 配列のインデックス範囲外(境界値エラー)にアクセスしている可能性を考慮し、安全なループ条件に修正してください。

無限ループや予期せぬ上書きを防ぐ安全装置の組み込み指示

実務コードでは、万が一の誤動作時に処理を強制的に停止させる「安全装置」を組み込むようAIに指定しておくと安心です。

# 追加する安全装置の指示例(プロンプトに追記)
- ループ処理(Do While / While)には、最大処理件数(例: 最大10,000回)のカウンターを設け、上限を超えた場合は「ループ上限に達したため処理を中断しました」と表示して脱出する安全装置を組み込んでください。
- 転記先シートにすでにデータが存在する場合は、上書きしてよいか確認するダイアログ(MsgBoxのvbYesNo、Browser.msgBox)を表示させ、「いいえ」が選ばれたら処理を終了させてください。

生成AIを活用したコード作成を実務に定着させる進め方

AIを使ったコード生成は、単発の作業で終わらせず、社内の共有資産として残していくことでリスキリングの効果が最大化します。

作成したコードを資産化するドキュメント残し

AIが生成したコードは、数か月後に自分やチームメンバーが見直した際、「何をしているコードなのか」が分からなくなりがちです。納品されたコードには、以下の情報をコード冒頭のコメントとして残すようAIに指示します。

# プロンプト追加指示
コードの最上部に、以下の項目を含めたメンテナンス用コメントヘッダーを出力してください。
- 作成日・更新日
- スクリプトの目的
- 前提条件(必要なシート名、配置する列の定義)
- 処理の大まかな流れ
- 担当者(変更時の連絡先用プレースホルダー)

このように構造化されたコメントを残しておけば、後日ツールの仕様変更やシートの列追加が発生した際も、そのコメントとコードを再度AIに読み込ませるだけで素早く改修コードを生成できます。


プログラミング学習とのバランスの取り方

生成AIを活用すれば、複雑な文法をすべて暗記する必要はありません。しかし、「完全な知識ゼロ」のままで実務コードを運用し続けることにはリスクが伴います。

  • 最低限理解しておくべきこと:変数の概念、IF文による条件分岐、FOR文によるループ処理、配列の基本構造
  • AIに任せてよいこと:複雑なオブジェクトの構文暗記、正規表現のパターン構築、定型的なエラーハンドリング構文の記述

基礎的なロジックの組み立て方がわかるようになると、AIへのプロンプト指示の解像度が上がり、出力されたコードの欠陥にも素早く気づけるようになります。コード生成の実践を通じて、「この処理は内部でどのように動いているのか」をAIに質問しながら、実践的なプログラミング知識を少しずつ蓄積していく進め方が効果的です。


まとめ

生成AIを使ってExcel VBAやGASのコードを作成・修正する実務手順を整理しました。

  1. プロンプトの具体化:実行環境、シート構造、処理条件、制約事項を明確に分け、曖昧な指示を排除する。
  2. データのマスキング:個人情報、取引先情報、APIキーなどは絶対にプロンプトに入力せず、ダミーデータと安全な取得設計を利用する。
  3. 段階的な動作確認:いきなり本番データで動かさず、バックアップ作成、ステップ実行、行数・合計値の検算を徹底する。
  4. 構造化されたエラー修正:エラー番号、停止行、変数の状態を正確にAIにフィードバックし、安全装置を含んだ修正を依頼する。

生成AIは、正しく条件を指定し、結果を厳格にチェックできる担当者にとって強力な業務改善ツールになります。まずは影響範囲の小さい単純な集計作業や下書き作成からステップを踏み、安全な自動化を実務に取り入れてみてください。


確認先

  • 日本マイクロソフト株式会社 公式ドキュメント(Excel VBA リファレンス)
  • Google Cloud 公式ドキュメント(Google Apps Script Guides)
  • 独立行政法人情報処理推進機構(IPA)「AI活用におけるセキュリティ」
まはろRe:Skill Blog 運営者・編集責任者

約11年にわたり、大手から中堅・中小企業まで事業戦略とマーケティングの支援に携わってきました。現在は個人や中小企業の支援に軸足を移し、現場で使える学び直しの情報を発信しています。

編集方針・誤りのご指摘はこちら

あわせて読みたい