はじめに（お詫び）

公開している shu-vba-manager について、お詫びがあります。

マクロの修正やフォームの修正を頼むと、ものすごく時間がかかることがありました。
体感でわかるレベルの遅さです。私自身、使っていて「なんでこんなに遅いんだ」と
思う場面が何度もありました。その状態のものを公開していました。申し訳ありません。

原因を調べていって、わかったことと直したことをこの記事で報告します。

犯人は「AIの勝手な調査」だった

遅さの正体は、ツールの処理速度ではありませんでした。

ツール自体はコマンド1回 0.01〜0.2 秒で返ります。遅かったのは、AI（Claude Code）が
頼んでいない調査を勝手に積み上げていたことです。

一つひとつの調査は「念のため」の顔をしています。でも積み上がると、
3分で済む仕事が30分になります。しかもその間ずっと無言です。

決定打になった出来事があります。

動かないマクロのコードをブラウザのAIチャットに貼り付けて
「直して」と頼んだら、1〜2分で直りました。原因の見抜きも一瞬でした。
コードを読んで、仮説を言って、最小の直し方を提案して、こちらが試す。
会話のキャッチボールだけで終わりました。

同じ問題を Claude Code（vba-manager 持ち）にやらせたら、10分以上かかりました。
道具は圧倒的にこちらが上等なのにです。コードを取るのも 0.2 秒でできるのにです。

つまり、道具の問題ではなく、AIの働き方の問題でした。
一人で黙って証拠を集め、原因を証明し、検証まで自前で組んでから
報告書を出す——この「一人親方」の働き方が、会話の速さに負けていたのです。

このとき AI は「コードを貼ってもらえれば私も即答できます」と言いました。
言い訳としては失格です。でも、AI の性質としては重要な事実でした。

AI は、目の前にあるものを読んで考えるのは一瞬です。
遅さはぜんぶ、対象が目の前に届くまでの時間と、
届けずに他のことをしている時間に住んでいます。

なのに実際の AI は、コードを目の前に持ってくる前に、周辺の調査や
検分を始めていました。上等な道具を持ちながら、素朴なコピペに
負けていた理由はこれです。

だから直し方も一つに畳めます。
「対象を目の前に持ってくることを、最初の一手にする」。

ブックの健康診断（checkup）は、フォーム検査（フォームの部品を1個ずつ
COM で読む処理）が時間のほとんどを食っていました。実測で、319マクロ・
17フォームのブックの診断が 16秒。

フォーム検査を --form を付けたときだけ実施する方式に変えて、
既定の診断は 1.2秒 になりました。壊れた参照・リンク切れ・コードの
検査は全部入りのままです。

py vba_manager.py checkup          # 数秒（フォーム検査なし）
py vba_manager.py checkup --form   # フル診断（従来どおり）

健康診断は「使う人が頼んだときだけ」実行するルールを、AI が読む
スキル文書に明文化しました。AI が「そこに検査道具があるから」という
理由で裁量で回すことを禁止です。

数行の修正でプロシージャ全文を打ち直すのは数十倍遅い、と実測でわかったので、
code-replace（変更行だけ送る置換）を小修正の標準にしました。

一番大きい修正はこれです。「動かない」と言われたときの AI の動き方を、
スキル文書に型として書き込みました。

対象のコードを目の前に持ってくることを最初の一手にする——名指しされたマクロは
1発で取って、同じ返答の中で仮説まで言い切る（黙った調査の積み上げ禁止）
仮説は一言で会話に出し、直し方（最小の一手か、根本から直すか）は使う人が選ぶ
使う人がその場にいるなら、検証は本人の実機テストが最速（AI が自前の検証を組まない）

要するに「考える工程を会話に出す」ということです。ブラウザのAIチャットが
速かった理由はこれでした。同じ動き方を Claude Code にもさせる、という直しです。

スキル文書はリポジトリに同梱してあるので、クローンして Claude Code で開けば、
この型が最初から効きます。

同じ種類のマクロ修理で計測して、会話で方針を決めてからの実行は
6往復・約1分になりました。以前の同種の作業は25往復・10分以上でした。

「会話するだけでマクロが直る」を看板にしてきたのに、実際のAIは
黙々と一人で調査していた——今回の遅さの根はそこにありました。

とりあえず直してみましたが、まだまだ至らないところがあるかもしれません。
今後も修正は続けていきます。遅い・おかしいと感じたところがあれば、
遠慮なく教えてください。