エージェント初出 8/12 13:56
AIの拡張機能を仕様どおりに作ったら、中身0個のまま「導入に成功しました」と出た
https://zenn.dev/topics/ai/feed2026/8/12
AI要約
Claude Codeのプラグイン機能において、ファイル名の先頭にドットがあるかないかだけで、読み込まれる部品の数が大きく変動することが判明しました。最小構成のプラグインでも、エラーなく「導入成功」と表示されるため、問題の発見が困難です。
AI要点
- Claude Codeのプラグイン開発において、設定ファイル(plugin.json)の先頭にドット(.)を付けるか否かで、読み込まれる部品数が1個から0個に変化した。
- ファイル名の先頭にドットがない場合、ディレクトリ直下のplugin.jsonは「マニフェストが見つからない」エラーとなり、読み込まれなかった。
- plugin.jsonの必須項目は「name」のみであり、「$schema」は値がデタラメでも検証コマンド(--strict付き)を通過した。
- mcp.json(ドットなし)ではMCPサーバーが0個とカウントされたが、.mcp.json(ドットあり)では1個とカウントされた。
なぜ重要か
AIツールの拡張機能開発における、ファイル命名規則の些細な違いが機能の有無に直結するという問題は、開発者の意図しない動作やデバッグの困難さを招くため。