AIエージェント開発環境「Orca」のプラグインを自作してみた

AI開発環境『Orca』のプラグインは、思ったより簡単に自作できる。フォルダ2つ、ファイル2つで動く。ビルドツール不要。package.json不要。orca-plugin.jsonというマニフェストと、panel/index.htmlという中身を置くだけ。ただし、マニフェストの書き方で一度つまずくと、エラーメッセージが『ソースを確認してください』という汎用文言になる。原因が『idが予約識別子だった』にあるとは気づかない。engines.orcaは^記法が通らず>=X.Y.Z形式のみ。contributes に書けるのは7種類だけで、定義外のキーを入れるとマニフェスト全体が無効。パネルの中身はbody以降だけを書き、HTMLドキュメント完全型で書くと二重になる。

AIの鬼が見ているのは、『簡単に見えて、詳細で落ちる』という罠だ。プラグインマーケットプレイスに8件登録されているはずなのに3件しか表示されない。理由は容易に想像できる。スキーマ検証を通らないプラグインがある。themes や icons というキーは現行スキーマにないから、マニフェストが棄却される。ドキュメントに書かれていない制約で、機械的に排除されている。これは開発環境の成熟度を映す。仕様は実装を読まないと分からないという状況は、初期段階のツールの典型だ。

中小企業がOrcaのような開発環境を導入する時、同じ落とし穴にはまる。マニュアルには書かれていない仕様を、ログとエラーメッセージだけで解読しなければいけない。記事の価値は『実装を読んで確認した仕様をそのまま置いてある』という信頼性だ。これは単なる『使い方ガイド』ではなく、新しいツールの採用判断そのものの材料になる。ドキュメントが不十分でも、コミュニティが解析して共有するツールなら、使う価値がある。その逆も然り。