DougTrajano/pydantic-ai-skills

解決する課題

このプロジェクトは、Pydantic AI フレームワークで構築された AI エージェント向けに「Agent Skills」を構築・管理する標準化された方法を提供します。開発者は、モジュール化されたドメイン固有の機能（指示、スクリプト、リソース）を作成でき、エージェントはそれらを動的に発見・ロードできるため、すべての指示を単一のシステムプロンプトに詰め込む必要がなくなります。

仕組み

フレームワークは Agent Skills のオープン仕様を実装しています。スキルは、Markdown ファイルやスクリプトを含むファイルシステム上のディレクトリとして、または Python コードでプログラム的に定義できます。

Pydantic AI エージェントに統合されると、フレームワークは「プログレッシブ・ディスクロージャ（段階的開示）」のためにツール呼び出しアプローチを使用します。エージェントはまず利用可能なスキルのハイレベルなリストを受け取り、必要に応じて特定のツールを使って該当スキルの詳細指示をロードしたり、リソースを読み取ったり、スクリプトを実行したりします。

対象者

Pydantic AI を用いて複雑な AI エージェントを構築する開発者で、モデルのコンテキストウィンドウを使い切ることなく多数の専門ツールや指示を管理したい方。

ハイライト

• プログレッシブ・ディスクロージャ：エージェントが関連性を判断したときだけ詳細なスキル情報をロードし、トークン使用量を削減します。
• 仕様互換性：Anthropic が維持する Agent Skills オープンフォーマットと完全互換です。
• 柔軟な定義：ファイルシステムベースのスキル（Markdown/スクリプト）とプログラム的な Python 定義の両方をサポートします。
• 型安全：Python のデータクラスと型ヒントを活用し、スキルメタデータと構造の検証を行います。
• セキュリティ：パストラバーサル防止と安全なスクリプト実行を組み込みです。