DougTrajano/pydantic-ai-skills

它解決了什麼

此專案提供一套標準化的方式，來建構與管理使用 Pydantic AI 框架的 AI 代理人的「Agent Skills」。開發者可以建立模組化、領域特定的功能（說明、腳本與資源），讓代理人能動態發現與載入，避免必須將所有可能的說明全部塞入單一系統提示中。

它如何運作

此框架實作了 Agent Skills 開放規範。技能可以以檔案系統中的目錄形式（包含 Markdown 檔與腳本）或以 Python 程式碼方式程式化定義。

當整合至 Pydantic AI 代理人時，框架使用工具呼叫的方式實現「漸進式揭露」。代理人首先會得到一個可用技能的高階列表；接著在需要時，使用特定工具載入相關技能的完整說明、讀取其資源，或執行其腳本。

目標對象

使用 Pydantic AI 建置複雜 AI 代理人的開發者，需要管理大量專門工具與說明，而不致耗盡模型的上下文窗口。

重點特色

• 漸進式揭露：僅在代理人判斷相關時才載入詳細技能資訊，降低 token 使用量。
• 規範相容性：完全相容於 Anthropic 維護的 Agent Skills 開放格式。
• 彈性定義：同時支援基於檔案系統的技能（Markdown/腳本）與程式化的 Python 定義。
• 型別安全：利用 Python 資料類別與型別提示驗證技能的中繼資料與結構。
• 安全性：內建路徑遍歷防護與安全的腳本執行機制。