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

「前任者のマクロが読めない」と諦める前に──ブラックボックス化したGASやVBAを、AI(Codex)で4分で仕様書にする方法

    社内の業務を支えている大事なExcelやGoogleスプレッドシート。

    その裏側で動いているマクロ(VBA)やGoogle Apps Script(GAS)を、いま誰が正確に把握しているでしょうか。

    「作った前任者はもう退職していて、コードが1行も読めない」
    「動いているから触らないようにしているけれど、エラーが出たら誰が直すのか」

    現場の業務改善やDXの相談をお受けする中で、もっとも多く耳にするのがこうした「ブラックボックス化したマクロへの恐怖」です。

    これまでなら、プログラマーや外部ベンダーに依頼して何日もかけてコードを一行ずつ読み解いてもらうしかありませんでした。
    当然、数十万円の調査費用がかかることも珍しくありません。

    しかし今、AIのコード解読機能を使うと、この景色がまるで変わります。

    手元の検証環境で試してみたところ、ブラウザで開いているGASのコードをAI(今回はCodex)に読み込ませただけで、わずか4分13秒で「人間が読んで業務が分かるMarkdown仕様書」が自動生成されました。

    しかも、単にコードを日本語訳するだけでなく、「コードのどこに未完成や不備があるか」まで表形式で洗い出してくれたのです。

    この記事では、実際にCodexを使ってGASを仕様書化したリアルなキャプチャを交えながら、ブラックボックス化したVBAやGASをAIで安全に棚卸しし、属人化を解体する実践的なアプローチをお伝えします。

    画像

    恐怖の正体は「コードが読めないこと」ではなく「業務が分からないこと」

    社内で「触るな危険」と言われているマクロやGASを前にしたとき、多くの現場担当者が感じるのは「プログラミングが分からないから直せない」という無力感です。

    しかし、冷静に状況を分解してみると、本当の恐怖は別のところにあります。

    • このツールは、どのフォルダからファイルを取ってきているのか

    • 処理が終わった後、どこに何を出力しているのか

    • どんなエラーが発生したときに止まる仕組みになっているのか

    つまり、「プログラミング言語の文法」が分からないこと以上に、「そのプログラムがどんな業務ルール(仕様)で動いているのかが分からないこと」が、現場を身動きできなくさせているのです。

    コードさえ読めれば、やっていることは単純な日常業務の繰り返しにすぎません。


    実際にCodexに投げてみた:指示文(プロンプト)はこれだけ

    今回は、GoogleスプレッドシートとGoogle Driveを連携させてファイルの移動や集計を行う、実務でよくあるGASツールを対象にしました。

    エディタには数本のスクリプトファイルがあり、フォルダの再帰取得や移動処理などが入り組んで書かれています。非エンジニアが見れば、どこから手を付ければいいか迷う構造です。

    そこで、AIツールのCodexに対して、チャット欄から以下のようにシンプルに指示を出しました。

    実際に投げた指示文(プロンプト):
    chromeブラウザで開いているApps Scriptのコードからこのツールの仕様書を作成したい。
    https://script.google.com/
    処理のフローを含めて、システムに詳しくない人でもこのツールの仕様を理解できるようにわかりやすくMarkdownファイルで仕様書を作成して。

    画像

    特別な専門用語や複雑なプログラミングの指定は一切していません。

    「ブラウザで開いているコードから仕様書を作ってほしい」「システムに詳しくない人でも分かるように、処理フローを含めてMarkdownで書いてほしい」と伝えただけです。


    4分13秒で何が起きたか:コードを読み込み、構造を解析していく

    指示を送信すると、AIはすぐに対象のプロジェクトをスキャンし始めます。

    画像

    画面左側に開いているGASのエディタ(コード一覧)を、AIが順次参照しながら解析を進めていきます。

    途中の進捗画面を見ていると、AIは単に文字を眺めているのではなく、「ファイル一覧の取得処理」「フォルダごとのカウント処理」「移動のロジック」といった機能の単位でコードを切り分けて整理していることが分かります。

    画像

    そして待つことわずか4分13秒。

    画面右側に、完成したMarkdown仕様書(仕様書.md)が出力されました。


    出力された仕様書を見て驚いたこと:「不備・バグ」まで指摘してくれる

    完成した仕様書を開いてみて、単なる要約以上の驚きがありました。

    画像

    出力された仕様書の冒頭には、次のように書かれていました。

    1. このツールでできること
    Googleスプレッドシートで指定したGoogle Driveのフォルダを調べ、ファイルの一覧を作成したり、別のフォルダへファイルを移動したりするツールです。フォルダ内の件数を数える処理と、整理対象のフォルダをログに表示する処理も含まれます。
    ただし、現在のコードには未完成・修正が必要な部分があります。すべての機能がそのまま正常に使える状態とは判断できません。 本書では、コードから分かる処理と制約を併記します。

    注目すべきは、後半の警告文です。

    AIは「何ができるか」を説明するだけでなく、コードの中身を精査した結果、「ここは未完成で不備がある」「ここは実際には動かない」という現実の欠陥まで見抜いて、表形式で整理してくれたのです。

    これを見た瞬間、「前任者がなぜこのコードを放置したのか」「途中で諦めたのか」という背景までが手にとるように理解できました。

    人間がコードを読んでこの不備を見つけようとすれば、何時間も集中してデバッグ作業をしなければなりません。

    それが、AIに投げてコーヒーを淹れている間の4分余りで、「このツールは何をしていて、どこが壊れかけの罠なのか」まで含めた完璧な業務カルテが出来上がったのです。


    AI仕様書化がもたらす「脱属人化」の3つのメリット

    この「AIによるコードの仕様書化」は、単なるプログラミングの時短にとどまりません。現場の業務改善やDXにおいて、決定的な3つの価値をもたらします。

    ① 「触ると壊れる恐怖」から解放される

    中身が分からないプログラムは、触るのが怖くて当然です。
    しかし、業務フローと制約条件が日本語のドキュメントになれば、「要するにA列のフォルダIDを読み込んで、B列に出力しているだけなんだな」と全体像が掴めます。
    怪物の正体が分かれば、恐怖はなくなります。

    ② 現場の担当者と経営陣が「同じ言葉」で話せるようになる

    「コードが読めない情シス」と「業務が分からない外部プログラマー」の間で起きていたすれ違いが、この仕様書を1枚挟むだけで解消されます。
    「この移動処理の不備だけ直せば、現場の朝作業が自動化できますね」という具体的な改善の議論ができるようになります。

    ③ 「直すか、捨てるか」の経営判断が数分で下せる

    ブラックボックス化したツールの中には、実はすでに使われていない不要な処理や、市販のツール(SaaSや標準機能)で簡単に代用できるものが多々あります。
    仕様書を見ることで、「わざわざ直す価値があるか、それともこの機会に別のツールに乗り換えるべきか」の判断が即座にできるようになります。


    仕組みがオープンになれば、業務改善は誰でも進められる

    「会社の重要な業務が、退職した誰かのマクロひとつに依存している」。

    これは、中小企業や成長企業において非常によくある、そして非常に危険なリスクです。

    しかし、何百万円もの費用をかけて大規模なシステム刷新を行わなくても、まずは手元のAIツールを使って「今動いているコードの正体を暴く」ことから始められます。

    コードが読めなくても構いません。

    ブラウザでマクロのエディタを開き、AIに「このツールの仕様書を、システムに詳しくない人向けに作って」と頼んでみる。

    その4分間の待ち時間の先に、長年誰も触れなかったブラックボックスを安全に解体し、現場の業務を再び自分たちの手に取り戻すための第一歩が待っています。


    もし少しでも参考になりましたら、下の「スキ(♡)」を押していただけると、次の記事執筆や検証の大きな励みになります!


    画像
     
     
    IT・システム責任者×BizDev。「高価なシステムを入れずに、手元のツールで業務をラクにする」をテーマに、生成AIの実務活用やGAS自動化、ガジェット検証をリアルに発信中。非エンジニアでも現場ですぐ試せる「小さな業務改善・脱属人化」のヒントをお届けします。

    あなたへのおすすめ