AIエージェントのスキル管理。増えすぎた機能を棚卸しする4ステップ

AIエージェント（＝指示を与えると自分で手順を踏んで作業するAI。Claude Code等）を業務に使い込むほど、便利な機能を次々と足していきます。スキル、カスタムコマンド、専門特化したサブエージェント。最初は5個だったものが、半年後には100個を超えていた。よくある話です。

ここで言うスキルとは、AIに覚えさせた業務手順のパッケージのことです。「広告レポートを作る手順」「議事録を要約する手順」のように、やってほしい作業を一式まとめて登録しておく。足すたびにAIが賢くなった気がして、つい増やしてしまいます。

ところが、ある日ふと「これ、どれが実際に使われているんだろう」と分からなくなる瞬間が来ます。登録簿には名前があるのに中身が空っぽのもの。中身はあるのに登録簿に載っていないもの。同じような手順が名前を変えて二重に登録されているもの。把握できていないAI運用資産は、増やすのは簡単でも、把握し続けるのが難しい。そして把握できていない資産は、誤動作や事故の温床になります。

この記事は、増えすぎたAIエージェントのスキルを棚卸しして整理するための、実務的な手順をまとめたものです。自社の環境で実際に試してみたところ、登録簿と実体がズレた状態（後述の「ドリフト」）が58個も溜まっていて、それを0にしました。その手順と、二度と溜めないための運用ルールまで書きます。

外部のAIツールを契約しすぎて費用と管理が膨らむ問題は、中小企業のAIツール乱立を防ぐ5つの習慣で別途扱っています。本記事はそれと棲み分けて、契約の話ではなく「1つのAIエージェント環境の中に溜まったスキル・設定という内部資産」をどう管理するかの話です。

結論：検出 → 3分類 → 復元/削除 → 再登録の4ステップ

棚卸しは次の4ステップで進めます。最小構成はこれだけです。

ここで言うドリフトとは、登録簿（レジストリ＝何が使えるかを記録した一覧）と実体（ディスク上に実際に置かれたファイル）がズレた状態のことです。スキル管理でいちばん大事なのは、検出したズレを十把一絡げに消さないこと。生きている機能まで巻き込んで消す事故が起きます。だから②の3分類が心臓部になります。

4つのステップの中身

ステップ1: ドリフトを検出する

まず、「実際に存在するスキル」の一覧と「登録簿に載っているスキル」の一覧を別々に作り、差分を取ります。差分がドリフトです。

操作としては、ディスク上のスキルフォルダを一覧化したファイルと、登録簿から抽出した一覧ファイルを用意し、両者を突き合わせて「片方にしかないもの」を抜き出すだけです。コマンドラインなら comm などの差分ツールで数秒で出ます。

ポイントは両方向を見ること。「実体はあるのに登録されていない」と「登録されているのに実体がない」は、別々に出して両方拾います。片方だけ見ると、もう片方の事故を見逃します。

ステップ2: ドリフトを3分類する

検出したドリフトを、そのまま消してはいけません。3つに仕分けます。

「壊れた参照」はリンク先が消えた抜け殻なので、消しても害はありません。一方で「生きた参照」や「実体」は中身を持っているので、消すと機能そのものを失います。分類せずに一括削除すると、まだ使っている機能まで巻き込んで消える。これが棚卸しでいちばんやりがちな失敗です。

ステップ3: 必要なものは履歴から復元、不要は削除、重複は統合する

分類が終わったら、方針に沿って処理します。

「本当は必要なのに、過去に誤って消されていた」スキルは、バージョン管理（git＝ファイルの変更履歴をすべて記録しておく仕組み）の履歴から復元できます。そのファイルが最後に存在した時点を履歴から探し、消される直前の状態を取り出すだけです。履歴さえ残っていれば、誤削除はほぼ取り戻せます。

不要な残骸は削除し、似た手順が二重になっているものは1つに統合します。ここで初めて「消す」を実行する。検出した直後にいきなり消さないのが、事故らないコツです。

ステップ4: 登録簿を再生成する

整理が終わったら、登録簿を作り直して、ディスクの実体とぴたりと一致させます。多くの環境では、実体フォルダをスキャンして登録簿を自動生成するスクリプトが用意されています。それを走らせれば、実体と登録が一致した「ズレ0」の状態になります。

ここまでが棚卸しの本体です。自社の環境では、この4ステップで58個あったドリフトが0になりました。

ハマりポイント3つ

手順自体は単純ですが、実際にやると引っかかる箇所があります。自社で挑戦する人も、外注先に確認する人も、知っておくと話が早いです。

ハマり1: 登録簿のスキャン範囲を最初に確認する

登録簿を生成するスクリプトが、特定のフォルダしか見ていないことがあります。「Aフォルダだけスキャンして、Bフォルダは見ない」といった具合です。

これを知らずにBフォルダへ実体を置くと、いくら正しく作っても登録されません。スキャン範囲外のフォルダに置いたスキルは、スキャン対象のフォルダ側に近道を張って認識させる必要があります。どのフォルダがスキャン対象なのかを、棚卸しの最初に確認しておきます。

ハマり2: 自動監査ツールの数値を鵜呑みにしない

整理を支援してくれる監査ツールが用意されている環境もありますが、その数値には誤差が出ることがあります。自社の環境では、ツールが「ドリフト16個」と報告したのに、自分で差分を取ったら58個ありました。3倍以上の開きです。

監査ツールの数値は出発点として使い、最終的な判断は差分コマンドなど自分の手で確認した実数で行う。ツール単独を信用しないのが鉄則です。

ハマり3: 並行作業で起きるロックファイルの競合

棚卸しを急いで、複数の作業を同時並行で走らせると、バージョン管理の内部ファイルがロック（一時的な使用中状態）のまま残ることがあります。「別のプロセスが動いているようだ」というエラーが出たら、残っているロックファイルと動作中のプロセスを確認してから対処します。焦って並行作業を増やすほど、この競合は起きやすくなります。

棚卸し前後で何が変わるか

棚卸しは「掃除して気持ちよくなる」だけの作業ではありません。AIエージェントの動作品質に直結します。

把握できていないスキルは、放置すると静かに増え続けます。動かないスキルが呼び出されて誤った結果を返しても、誰も気づかない。把握できている状態を保つこと自体が、運用の安全装置になります。

業種に応じて不要なスキルを見極める

棚卸しでは「壊れているか／生きているか」だけでなく、「自社の業務で本当に使うか」という視点も必要です。

AIエージェントのテンプレートには、汎用的に多くのスキルが最初から含まれていることがあります。これを「とりあえず全部入れておく」と、AIが毎回の判断で大量の機能を見比べることになり、処理が重くなったり精度が落ちたりします。AIにとっての作業机が、使わない道具で埋まっている状態です。

仕分けの考え方は2つです。

• 業種固有で不要なもの：たとえばSaaS向けの解約防止や収益運用の手順は、別業種では使いません。無効化または削除します
• 業種を問わず転用できるもの：A/Bテスト、価格戦略、マーケティング心理学などは、どの業種でも使えます。残します

自社の業務で実際に使うものだけを有効にして、残りは外す。スキル管理は「ズレを消す」だけでなく「使わないものを持たない」までを含みます。

棚卸しを定期運用に組み込む

一度きれいにしても、運用を続ければまたドリフトは溜まります。スキルを足したり消したりするたびに、登録簿との小さなズレが少しずつ蓄積するからです。だから棚卸しは「気が向いたとき」ではなく、頻度と担当を決めた定期運用にするのが安全です。

重いのは四半期の棚卸しだけで、毎月のチェックは検出コマンドを1回走らせて件数を見るだけです。件数が二桁に増えていたら、四半期を待たずに整理する。この軽い見回りを習慣にしておくと、58個も溜めてから慌てる事態を避けられます。

こんなケースには棚卸しが向かない

正直に書いておくと、すべての環境でこの手順が要るわけではありません。次のようなケースでは、棚卸しの手間のほうが大きくなります。

• スキルが10個程度で全部把握できている：頭の中で管理できるうちは、仕組み化のコストが見合いません
• バージョン管理をしていない：履歴がないと誤削除を復元できないため、棚卸しの前にまず変更履歴を残す運用から始めるべきです
• 1人だけが使う環境で当面拡張しない：増えない環境ならドリフトも溜まりません。チームで共有し始めたタイミングで導入すれば十分です

逆に、複数人で1つのAIエージェント環境を共有していて、スキルが数十個以上あり、今も増え続けているなら、棚卸しの仕組み化は早めにやるほど後が楽になります。

棚卸し前チェックリスト

着手する前に、次を確認しておくと作業がぶれません。

• バージョン管理（git等）でスキルの変更履歴が残っているか（誤削除の復元に必須）
• 登録簿を生成するスクリプトが、どのフォルダをスキャンしているか把握しているか
• 検出は両方向（実体のみ／登録のみ）を取る前提になっているか
• 消す前に必ず3分類を挟む手順になっているか
• 棚卸し中に他の人が同じ環境を触らない段取りになっているか（ロック競合の回避）
• 整理後の定期運用（頻度・担当）を決めてあるか

この6つが押さえられていれば、検出から再登録までは半日もかかりません。

まとめ：スキル管理は「分類してから処理し、定期で見回る」

増えすぎたAIエージェントのスキルを整理する流れを、もう一度整理します。

1. 登録簿と実体を突き合わせてドリフト（ズレ）を検出する
2. 「壊れた残骸／生きた参照／実体」の3つに分類してから処理する
3. 必要なものは履歴から復元、不要は削除、重複は統合し、登録簿を再生成する
4. 業種で使わないスキルは外し、頻度と担当を決めて定期的に見回る

AIエージェントは機能を足すのは簡単です。難しいのは、足したものを把握し続けること。把握できていないスキルは、いつか壊れたまま呼び出されて誤動作の原因になります。スキル管理を「分類してから処理する」と「定期で見回る」の2本立てで仕組み化すれば、機能を失わずにスリムな状態を保てます。

AIエージェントのスキルが増えすぎて把握できないなら

「スキルやカスタム機能を足してきたが、今どれが生きているか分からない」「動かないまま放置されている機能がありそうだが、消していいのか判断できない」。AIエージェントを業務に組み込んでいる会社で、こうした声をよく聞きます。把握できていない運用資産は、増えるほど事故のリスクになります。

f2t.jpでは、AIエージェントの構築から、スキル・機能の棚卸し、定期運用ルールの設計まで一貫してお手伝いしています。まずは「今いくつスキルがあって、どれが使われていて、どれを残すか」を一緒に洗い出すところから始められます。お問い合わせフォームから、自社のAIエージェントの整理についてご相談ください。