DougTrajano/pydantic-ai-skills

解決する課題

AIエージェントがプロンプトの肥大化を避けながら能力を拡張できるようにします。"段階的公開"を活用することで、エージェントは利用可能なスキルの高レベルなカタログ（名前と説明）のみを表示し、特定のタスクが必要な場合にのみ、詳細な指示、参考資料、または実行可能スクリプトを読み込みます。

動作方法

このプロジェクトは、"エージェントスキル"と呼ばれるモジュール化されたパッケージを管理するシステムを実装しています。各パッケージには SKILL.md ファイルが含まれ、指示を記述し、オプションでスクリプトやリソースを含めることができます。pydantic-ai-harness を拡張し、以下の機能を追加しています：

• リモートレジストリ：GitリポジトリやS3バケットからスキルを取得できる機能。
• バンドルファイルの実行：read_skill_resource および run_skill_script といったツールにより、エージェントがスキルに関連するバンドルドキュメントを読み取るか、スクリプトを実行できるようになります。
• サンドボックス：信頼できないスクリプトをコンテナや仮想ファイルシステム内で実行するサポートにより、ホストマシンを保護します。
• プログラムによる定義：デコレータやデータクラスを使って、Pythonコード内で直接スキルを定義できる機能。

対象ユーザー

Pydantic AIでエージェントを開発しており、多数の専門的タスクのライブラリを管理したい開発者。外部のスキルレジストリ（例：Anthropicのスキルレジストリ）を統合したいが、セキュリティとプロンプト効率を維持したい人向けです。

主な特徴

• 段階的公開：詳細な指示は必要に応じてのみ読み込まれるため、プロンプトのオーバーフローを防ぎます。
• リモートソース：GitとS3レジストリをサポートし、フィルタリングやマージ機能も備えています。
• 安全な実行：バンドルされたスキルスクリプトの実行にサンドボックスオプションを提供します。
• 動的解決：スキルファイル内の ${SKILL_DIR} パスプレースホルダを自動的に処理します。