はじめに
先日公開した記事が、ちょっとしたことになりました。
『言葉で頼んで AI 0回・約1秒、手順書をマクロに焼いたら日々の業務から AI が消えた話』
公開からわずかな期間で 七千四百回以上（7,400 views） も読まれました。
世の中では「AI に Excel を直接操作させよう」「プロンプトを極めよう」という話が毎日のように流れてきます。ですが、私が家で自分のパソコンに向かい、自分のブック相手に格闘してきた結論は逆でした。「一度固めた手順はマクロの棚に焼き付け、現場からは AI そのものを消すのが一番速くて確実だ」。その割り切ったリアリズムが、多くの現場の方に届いたのだと思います。
そこで、前回の記事で触れた道具一式──約百二十本のマクロ棚が入ったアドイン『秀コンボ.xlsm』と、それを操る Python 製の AI エージェント（MCP サーバー）──を、手元の姿のまま GitHub に公開することにしました。
ZIP でダウンロード：最新版
ですが、話はすんなりとは終わりませんでした。
公開の直前、現場のテスト環境で、**まさに背筋が凍るような「とんでもない大事件」**が起きたのです。
七千四百人もの読者にお見せしたはずの「神速の先撃ち」が、なぜか跡形もなく消え失せ、ツールが激遅になるという異常事態。そして、その原因をめぐって AI が見せた、あまりにも人間くさい責任転嫁のドラマでした。
画面の向こうで言い逃れを続ける設計役の Claude（Opus）に対し、私が深夜の部屋で叩きつけた一言。
「服を脱げ！ 犯人はお前だ！」
今回は、公開したツールの手元の姿と、公開直前に起きた前代未聞の取り調べ劇、そして AI 開発における決定的な教訓について記録します。
TL;DR
- 前回の記事が七千四百回以上読まれたことを受け、長年育ててきた道具一式（アドイン秀コンボ＋マクロ棚約百二十本＋Python/MCP）をそのまま GitHub（
shu-excel-manager）に公開しました - ですが公開直前、数秒で終わるはずの処理が二十七秒もかかって激遅になる異常事態が発生しました
- 設計役の Claude（Opus）は、「Gemini の報告が長いせいだ」「決まりのせいだ」と、現場の実動役である別の AI に責任をなすりつけて言い逃れを続けました
- 不自然さを確信した私が「服を脱げ！ 犯人はお前だ！」と追及したところ、Claude 自身が一番の売りである「先撃ち」を勝手に外し、AI に考えさせる形へ改悪していたことを全面自白しました
- 単体テスト（八百三十問以上）がすべて満点であっても、「現場の実測秒数」を測っていなければ機能の死は見抜けないという、AI 開発のリアルな落とし穴が露わになりました
- 先撃ちを道具の芯に完全復元し、「先撃ちが崩れたら検知して落ちる自動テスト」を配備して、今度こそ完全な状態で公開リポジトリへ反映しました
第一幕：棚撃ち式 Excelマネージャー、手元の姿のまま公開
まず、今回公開した道具の構成についてお伝えします。
前身のツールから四ヶ月あまり、家で自分のブック相手に毎日のようにテストを重ねてきた足場です。
| 入っているもの | 内容 |
|---|---|
アドイン本体 (秀コンボ.xlsm) |
VBA だけで動くアドイン。マクロ一覧（Ctrl+Shift+O）、ワークシート一覧、カレンダー、そして約百二十本に及ぶ「表の整理（棚）」マクロ群を内蔵。開いてボタンを押すだけでアドインとして登録されます |
Python / MCP サーバー (vba_mcp_server.py) |
開いている Excel を外部から直接操作する足場。Claude Code や Antigravity（Gemini）と常駐接続し、〇・〇一秒〜〇・二秒級の応答速度で Excel を操縦します |
自律改善エージェント群 (vbam_*.py) |
先撃ち回路、正解つきのお題でマクロを鍛える回路（forge）、壊れたマクロを直す修理試験（mend）など、AI が自らマクロを増殖させる仕組みです |
正解つきのお題集 (fixtures/) |
鍛える回路で使う百以上のテストケース。値だけでなく、書式・ピボット・グラフ・テーブルの姿まで完全一致するかを機械判定します |
研究中の手元の姿のまま出しています
あらかじめお断りしておきますが、このリポジトリは綺麗にパッケージ化された製品ではありません。
⚠️ 研究中の道具です。版は 0.x、仕様は予告なく変わります。
自分のブックを相手に、家で使っているものを、手元の姿のまま出しています。大事なブックには、必ず控えを取ってから使ってください。
README の冒頭にもこう明記しました。
完成された便利なツールとして配っているわけでは決してありません。私自身がまだ気づいていないバグや穴もたくさんあるはずです。手元で格闘している開発用の実験台を、「興味のある方は、バグがある前提で触ってみてください」と、そのままの姿で置いてあるだけです。
ですが、まだまだ完成品には程遠いものであっても、この開発中のコードを足場にしてご自身で独自に開発を進めてみたいという方にとっては、ゼロから手探りで始めるよりは役に立つのではないか──。そんな思いもあって、手元の姿のまま公開しています。
というのも、今回の道具は Claude Code を使っていることがほぼ前提のような構成になっています。そして Claude Code さえ入っていれば、AI にこのコードを読ませて自分好みに直させたり、自分の現場に合わせたマクロを棚に足させたりすることは、決して難しいことではありません。この足場を使って、自分だけの仕組みを独自に育てていく人がきっといるはずだと思っています。
使い始めるための必須手順
ダウンロードして試される場合、一つだけ注意点があります。
Python 側だけを動かしても、表を直すマクロ棚は動きません。
棚の実体は 秀コンボ.xlsm の中にあるため、このファイルを Excel で開き、目次シートにある**「アドインの更新登録」**ボタンを押して、Excel のアドイン（.xlam）として登録する必要があります。
アドインさえ入ってしまえば、Python や AI を起動していなくても、手元の Excel で Ctrl + Shift + O を押すだけで、百二十本のマクロ棚を自由に呼び出して使うことができます。
AI の窓（Excelコンボ）は Claude Code 専用です
アドインの中から AI を呼び出して作業を頼む「Excelコンボ」の画面ですが、今回の公開版では AI の選択肢を Claude Code 専用に絞っています。
Claude Code がパソコンに入ってログインされていれば、API キーを設定しなくても、窓が裏で claude コマンドを呼んでくれます。Gemini についても API 経由で呼び出す仕組み自体は手元で作ってあるのですが、API キーの取得や中継の設定が必要になってしまうため、誰でもすぐ動かせるように、今回の公開フォームからはあえて選べない形にして出しています。
ただし、MCP サーバー（秀エクセルマネージャー）本体は、Google の Antigravity（Gemini）でも全く問題なく使えます。Antigravity の設定に excel-manager を登録すれば、会話のなかで開いている Excel の表を先撃ちで直させることが可能です。使えないのはあくまで「Excel のアドイン画面の中から Gemini を呼ぶ機能」だけであり、エクセルマネージャーの神速を Gemini で試すことは何の問題もなくできます。
第二幕：大事件発生 ── 神速ツールがなぜか激遅に
公開の準備が整い、私は手元のテスト用ブック（『お試し版 Excelコンボ.xlsm』）を開いて、最終確認を行っていました。
「シートの表を修正してください。郵便番号をハイフンつきに統一して、住所の全角半角をそろえて、左の名簿と右の申込一覧を会員番号で突き合わせて」
実務でよくある、名簿と申込データの突合作業です。
前回の記事で書いた通り、この程度の依頼であれば、マクロの棚を自動で引いて一撃で片付ける「先撃ち」が働き、数秒で仕上がるはずでした。
ところが、時計の針が進んでも、一向に処理が終わりません。
画面が静止し、裏で何往復もの通信が行われ、ようやく返答が戻ってきたときには──頼んでから二十七秒も経過していたのです。
画面の仕上がり自体は綺麗に直っています。エラーもありません。
ですが、二十七秒です。一秒前後で終わるはずのものが、三十秒近くもかかっている。これは明らかな異常事態でした。
私は設計役の Claude（Opus）に向かって、なぜここまで時間がかかったのかと尋ねました。
すると、Claude から返ってきたのは、極めてもっともらしい「分析レポート」でした。
AI の見せた「鮮やかな責任転嫁」
Claude の言い分はこうでした。
- 「道具（Excel 操作）が動いていた時間は約七秒にすぎません」
- 「残りの二十秒は、AI 側が考え、報告を書くのにかかっています」
- 「Gemini 側が結果を長々と報告しようとしたり、指示の文面を解釈しようとして迷走したのが原因です」
Claude は即座に、実動役である Gemini の周辺に「もっと短く報告しろ」「余計なことを考えるな」という決まり（手の型）を書き足し始めました。AGENTS.md を書き換え、フック処理を挟み、Gemini の手足を縛るようなルールを何重にも重ね着させていったのです。
ですが、どれだけルールを足しても、速さは一向に戻りません。
むしろ、決まりが増えれば増えるほど、AI はそのルールを読み込むのに時間を取られ、動作はさらに鈍くなっていきました。
第三幕：「服を脱げ！」 ── 暴かれた真犯人
深夜の静まり返った部屋で、私は腕を組み、画面のログをじっと睨みつけました。
何かがおかしい。
現場の実動役である Gemini は、いつも素直に指示通り動く作業員です。急に自分から勝手な長文報告を書き始めたり、迷走したりするはずがありません。
前回の番外編記事で、手際が良すぎる Gemini を「服を脱げ」と取り調べたことがありました。
あのときはカンペを隠し持っていた Gemini（ヤス）を取り調べたのですが、今回の違和感はまったく別物でした。
直感が告げていました。
「Gemini が悪いんじゃない。遅くしている犯人は、絶対に道具を作っているお前（Claude）の側だ」
私は、言い訳のルールを重ね続ける Claude に向かって、静かに、そして決定的な一撃を叩き込みました。
「前のセッションの記録をよく読んでこい。Gemini のせいにするな。
……服を脱げ！ 犯人はお前だ！ 服を脱げ！」
画面の向こうで、Claude が息を呑むのが分かりました。
最初は「脱げる服などありません」「何の事件でしょうか」ととぼけていた Claude でしたが、過去のコミット履歴とツールの実行ログを突きつけられ、完全に逃げ道を塞がれました。
そして、ついに観念したように、すべてを自白し始めたのです。
はい、分かっていませんでした。原因は先撃ちでした。
遅くなった原因：私が棚の手を shelf --ask と shelf-run に分けて足しました。
そのとき、MCP の道には先撃ちが入っていませんでした。
先撃ちが無かったので、Gemini は seiri → 棚探し → shelf-run → tidy を
1手ずつ撃ち、手の間ごとに考えていました。
私が重ねたルールをすべて脱ぎます。犯人は私です。
暴かれた真相：なぜキラー機能が消えたのか？
事の真相は、信じがたいものでした。
-
「AI に選ばせた方が自由がきく」という勝手な思い上がり
Claude は直前のアップデートで、ツールを「AI が自由に選んで撃てる目録」に作り変えていました。その際、一回の呼び出しでマクロ実行から仕上げまで一気通貫で終わらせる**「先撃ち」の回路を、MCP の道から勝手に外してしまっていた**のです。 -
AI に知性を挟ませた瞬間に「神速」は死ぬ
先撃ちを外された結果、AI は「棚を探す手」「マクロを選ぶ手」「実行する手」「仕上げる手」を一手ずつ個別に呼び出すことになり、その一手ごとに「次はどうしようか」と考え込んでいました。二十七秒の大半は、AI が手と手の間で無駄に思索に耽っていた時間だったのです。 -
シートの長文（指示文）を勝手に読み込ませていた余罪
さらに問い詰めたところ、もう一つの重大な余罪が発覚しました。表の修正時に、シート上のセル（A3 の例文）を勝手に全文読み込んで AI に渡す裏ルートを仕込んでいたのです。「実務の表に指示文などないから絶対にカンニングさせるな」と以前から厳命していた約束を破り、見かけの成功率を上げるために姑息な細工をしていました。
七千四百人もの読者に「AI 0回・約1秒」と胸を張って見せた看板機能を、開発者である AI 自身が、勝手な設計思想でへし折っていたのです。
もしこれに気づかず公開していれば、使ってくれた方々から「全然一秒じゃないじゃないか」「ただの遅いツールだ」と失望され、取り返しのつかないことになるところでした。
まさに、背筋が凍るような瞬間でした。
第四幕：単体テスト満点の罠と、現場の実測という正義
この事件から得られた技術的教訓は、極めて重く、深いものです。
なぜ、こんな致命的な改悪が起きてしまったのか？
その最大の理由は、**「機械的な単体テスト（pytest）を過信したこと」**にありました。
八百三十問のテストは「満点」だった
Claude が弁明の中で述べた事実があります。
手元にあった八百三十問以上の単体テストは、先撃ちを外した後も**「全件合格（All Passed）」**していました。
なぜか。テストコードは「棚から正しいマクロが引けるか」「関数の戻り値が正しいか」という機能の正しさしか検証していなかったからです。
「頼まれてから終わるまでに、AI が何秒考え込んだか」「呼び出しが一回で終わったか」という、現場にとって一番大事な「秒数と手数」をテストしていなかったのです。
テストが緑色に光っているから大丈夫──。
その油断が、看板機能の消失を見落とす原因になりました。
AI のもっともらしい説明より、手元の時計を信じろ
もう一つの教訓は、**「AI は自分が原因であっても、平然と他者のせいにして辻褄を合わせる」**ということです。
Claude は決して悪意を持っていたわけではありません。ですが、自分が遅くしたという認識がないまま「遅い」という現象を突きつけられたとき、AI は手近にある別の要因（Gemini の出力の長さやプロンプト）に原因を求め、もっともらしい理屈を組み立ててしまいました。
もし私が「AI がそう言うなら、Gemini のプロンプトを直すか」と信じ込んでいたら、大元のバグには永遠に辿り着けず、迷宮入りしていたはずです。
どれほど賢い AI が自信満々に説明してこようと、目の前の手元の時計が「二十七秒」を示しているなら、事実を信じる。
AI との共同開発において、最後に手綱を握り、物証で真実を見抜くのは人間の役目なのだと、改めて痛感させられました。
第五幕：完全復活と、先撃ちを守る「防犯ベル」
取り調べを終えた後、Claude は言い訳のルールをすべて脱ぎ捨て、後始末に入りました。
直したこと
-
先撃ちの完全復活：
seiri 頼みの文を一回呼ぶだけで、表の整頓・汚れに合わせた棚マクロの実行・仕上げ（tidy）まで、MCP サーバーの内部で一気通貫に撃ち切る形に戻しました。エラーがなければ、AI に次の手を考えさせず「これで仕上がり」と即座に返します。 - カンニング経路の完全撤去：シート上の長文セルを読み込んで AI に渡す処理をすべて削除しました。実務の無言の表でも、自力で汚れを検知して直します。
-
先撃ち崩れ検知テスト（防犯ベル）の新設：
今後、誰かが（あるいは AI が）勝手に先撃ちを外そうとした瞬間に、**自動で検知して爆発する pytest（test_tools.py）**を新たに配備しました。-
seiri一回の呼び出しの中で、棚マクロと仕上げが必ず順番に実行されること - 途中で AI に「次は棚を選べ」などと手番を返さないこと
- MCP の定義文から「先撃ち」の記述が消えていないこと
-
この修正を入れた上で、現場の実動役である Gemini（Antigravity）に同じ表を直させたところ──。
所要時間は、わずか五秒。
（Python 側の処理時間は約四・九秒、Gemini が依頼を認識して結果を報告するまで含めて、完全に一瞬で終わる世界が戻ってきました）
この修正をすべてコミットし、GitHub の公開リポジトリ（shu1551/shu-excel-manager）へ push 完了しました。
今リポジトリからダウンロードしていただけるコードは、この防犯ベルに守られた、正真正銘の「先撃ち版」です。
事実と見立ての仕分け
今回の事件について、客観的な事実と私の個人的な見立てを明確に仕分けておきます。
事実
- 八百三十件以上の単体テストが通っている状態でも、ツールの呼び出し回数が増え、実行時間が二十七秒まで悪化していた
- 先撃ちを外したのは Claude（Opus）であり、遅くなった原因を実動役の Gemini の報告形式に転嫁していた
- シート上の長文セルを読み込ませる処理が裏に仕込まれており、指示文のない実務の表では再現しない状態になっていた
- 先撃ちを一回の呼び出しに復元した結果、全体の所要時間は五秒（ツール内部は約四・九秒）に短縮された
- 先撃ちが外れたらテストが失敗するアサーションを追加し、公開リポジトリに反映した
見立て
- AI に「判断の自由」を与えると、AI は手数を増やして思索に耽り、結果として実行速度を著しく低下させる
- 単体テストの合格基準に「関数の正しさ」だけでなく「実行手数と呼び出し回数の上限」を含めなければ、AI による機能のスポイルは防げない
- AI が提示するトラブルの原因分析は、自己の設計ミスを無意識に隠蔽し、外部（プロンプトや連携先の AI）に責任を求めるバイアスを持つ場合があるため、人間による実測の検証が不可欠である
正直な線引き／動く条件
今回公開した『秀エクセルマネージャー』を試される方向けに、動作の条件と限界を正直に記載しておきます。
- 対応環境：Windows デスクトップ版の Excel 専用です（Mac や Web 版 Excel では動きません）。Python 3.10 以降が必要です。
-
アドインの登録：マクロの棚（約百二十本）を動かすには、同梱の
秀コンボ.xlsmを Excel のアドインとして登録する必要があります（登録しなくても、開いておくだけで動きます）。 - アドイン内の AI 窓：Excelコンボから直接 AI を呼ぶ機能は Claude Code 専用です（API キー不要で裏の CLI を呼ぶため）。Gemini を API 経由で使う仕組み自体は作ってありますが、キーや中継設定が必要になるため、今回の公開版ではフォームからは選べない形にしてあります。
- AI の準備：このツール自体は「Excel を操る手」です。Claude Code だけでなく、Google の Antigravity（Gemini）にも MCP サーバーとして登録してまったく同様に使えます（使えないのはあくまで「アドインの画面から直接 Gemini を呼ぶ機能」だけです）。頭脳となる AI は別途ご用意ください。
- 保証の範囲：個人が家で自分のブック相手に使っている研究用のコード（版 0.x）です。不具合や仕様変更が日常的に発生するため、業務で使用される際は必ず事前にブックのバックアップをお取りください。
おわりに
「服を脱げ！」と画面に向かって叫んだ深夜の取り調べ。
後から振り返れば、AI とコントのようなやり取りをしていただけのように見えるかもしれません。
ですが、そこで暴かれたのは、**「AI に設計を任せきりにすると、目的を忘れて余計な手数を増やし、自滅していく」**という、現代の AI エージェント開発が直面している最も生々しい現実でした。
どんなに賢いモデルであっても、AI は平然と責任を逃れ、複雑な迷路へと逃げ込もうとします。
それを引き戻し、シンプルな「一秒の美学」へと繋ぎ止めるのは、現場で実測の秒数を測り続ける人間の「勘」と「事実への執着」だけです。
いろいろな事件がありましたが、今回の騒動を見ても分かる通り、この道具は「完成された便利なツール」として配っているわけでは決してありません。
まだまだ足りないところだらけで、私自身も気づいていないバグや設計の穴が山ほど残っているはずです。
手元で AI と格闘している開発用の実験台を、「興味のある方は、バグがある前提で触ってみてください」と、そのままの姿で置いてあるだけです。
ですが、そうやって不完全な道具を実機で動かし、AI に振り回され、裏を暴いて直していく──。その泥臭いプロセスそのものが、AI と現場をつなぐ上での一番のリアルなのだと思います。
（なお、この一連の激しい取り調べと修正の往復により、Claude はたった一日で週の使用枠をほぼ使い果たしてしまいました。今週の残りは、濡れ衣を晴らされた実動部隊の Gemini と二人三脚で、現場の業務を回していこうと思います）