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 数据类和类型提示验证技能元数据和结构。
• 安全性：内置路径遍历防护和安全的脚本执行。