1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | building-pydantic-ai-agents | GitHub API / SKILL.md |
| 作者/维护者 | Pydantic（Pydantic AI 框架核心团队，含首席维护者 Douwe Maan） | GitHub API |
| 来源链接 | https://github.com/pydantic/pydantic-ai/tree/main/pydantic_ai_slim/pydantic_ai/.agents/skills/building-pydantic-ai-agents | — |
| 许可证 | MIT（仓库 LICENSE 文件明确写明） | GitHub API |
| GitHub Stars / Forks | 18,979 / 2,458（口径为 Pydantic AI 框架主仓库；该技能是框架自带的官方内置资产，随框架源码一同发布，并非独立技能仓库） | GitHub API |
| 最新版本 | v1.1.1（SKILL.md 元数据自述） | 网页抓取（SKILL.md） |
| 安装方式 | Claude Code 官方插件市场一条命令安装 / npx skills CLI 跨 Agent 安装 |
网页抓取（README） |
2. 功能介绍与亮点
教编码 Agent 用 Pydantic AI（一个受 FastAPI 启发的类型安全 Python Agent 框架）构建生产级应用，覆盖从入门到进阶的完整心智模型：
- 核心用法速查：创建基础 Agent、用
@agent.tool/@agent.tool_plain添加工具、结构化输出（Pydantic 模型作为output_type）、依赖注入、流式事件。 - 进阶主题按需加载：配套 11 篇专题参考文档（工具进阶、Hooks 生命周期拦截、能力按需加载、多智能体委托与图编排、消息历史处理、测试与调试等），SKILL.md 正文仅作路由，具体任务时才加载对应文件，避免一次性占满上下文。
- “常见坑”清单：单列一节收录该框架特有的高频错误，例如
tool与tool_plain的参数签名差异、模型字符串必须带 provider 前缀、TestModel必须配合agent.override()使用等——这类内容通常只存在于资深使用者的踩坑经验里。 - 明确划清边界：SKILL.md 开头即写明“不要用于纯 Pydantic 校验库场景（无 Agent 时）、不要用于 LangChain/LlamaIndex/CrewAI/AutoGen 等其他框架”，减少误触发。
- 技能内容直接维护在 Pydantic AI 框架自身仓库的
.agents/skills/目录下，随框架版本发布同步更新，而非社区二次转译；pydantic/skills聚合仓库通过自动化脚本将其镜像分发。
3. 适用场景
所属分类：元技能与 Agent 增强
面向用 Pydantic AI 框架搭建 LLM 应用或 Agent 的 Python 开发者，尤其是使用 Claude Code、Codex 等编码 Agent 协助写代码的初中级用户。典型场景：让编码 Agent 生成符合框架当前 1.x API 的代码而非训练数据里的过时用法；给 Agent 加结构化输出、多工具调用或多 Agent 委托；用 Hooks 拦截模型请求做审计或重试；从其他框架迁移到 Pydantic AI 时快速补齐框架特有心智模型。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——Pydantic 官方在 Claude 插件市场发布
pydantic-ai插件（claude plugin install pydantic-ai@claude-plugins-official），也可用npx skillsCLI 装入.claude/skills/。 - Codex：✅ 原生支持——Pydantic 官方文档明确将 Codex 列入受支持的编码 Agent。
- OpenClaw：❓ 未验证——抓取到的官方材料未点名提及。
- Hermes Agent：❓ 未验证——抓取到的官方材料未点名提及。
官方文档称该技能遵循 agentskills.io 标准、支持“30+ 编码 Agent”，但未逐一点名 OpenClaw、Hermes Agent。
5. 推荐理由
Pydantic AI 是对标 LangChain 的类型安全 Agent 框架，这份技能由框架团队直接维护在框架自身代码库里，版本与 API 同步更新，不会像社区转译文档那样滞后。渐进式披露的信息架构（主文件路由 + 11 篇任务族参考文档）本身就是值得参考的 Skill 工程范例，覆盖入门到多 Agent 编排、Hooks、测试的完整链路。技能内容是纯 Markdown 指令与代码示例，无脚本、无网络调用，审计成本极低。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 所属 Pydantic AI 框架 GitHub 18,979 星、2,458 fork，MIT 开源，Hacker News 多次被独立讨论（如“Building your own CLI coding agent with Pydantic-AI”）；技能本身被 Pydantic 官方文档站单列说明，并接入 Claude Code 官方插件市场 |
| 可用性 | 9 | 官方插件市场一条命令即装，或用 npx skills 跨 Agent 安装；主文档 + 11 份分主题参考文档，示例代码可直接运行；子目录提交记录显示近 5 个月由多名核心维护者（含首席维护者 Douwe Maan）持续迭代，最近一次提交为 2026-07-31；无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 无脚本、无 shell 执行；SKILL.md 与参考文档中的 Python 代码均为示例片段，供开发者在自己项目中编写，技能本身不代为运行 |
| ② 运行时联网外发 | 无网络请求，纯本地代码编写指导 |
| ③ API Key/凭据存储 | 不涉及技能自身的凭据存储；示例中出现的 ANTHROPIC_API_KEY 等环境变量是 Pydantic AI 框架运行本身的前提，用法透明 |
| ④ 可疑指令 | 未发现 prompt injection 或隐蔽指令迹象 |
| ⑤ 作者信誉 | Pydantic 官方团队出品，无造假迹象 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 2026-07-31 有提交，非弃置项目 |
综合评分（三项均值）：9.0
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| langchain-ai/langchain-skills（LangChain 官方） | 面向 LangChain、LangGraph 与 Deep Agents 生态的编码 Agent 技能集 | 定位相近但仓库未附 LICENSE 文件；信息架构以细颗粒度单技能（如 eval-engineering）为主，不是单一路由文件 + 参考文档的渐进式披露结构 |
| crewAIInc/skills（CrewAI 官方） | 教 Agent 用 CrewAI 的“角色扮演”式多 Agent 编排框架（Crew/Flow）开发 | 聚焦项目脚手架与架构决策（何时用 LLM.call() 还是 Crew.kickoff()），仓库同样未附 LICENSE 文件；覆盖广度不及本技能的任务族参考文档体系 |
| Fuenfgeld/pydantic-ai-skills（社区版） | 第三方开发者独立编写的 Pydantic AI 技能，涵盖依赖注入、验证器、评估框架等模式 | 非框架官方出品，更新节奏与 API 变化不直接绑定，需自行判断是否跟得上 Pydantic AI 版本迭代 |
三者都是框架方或社区为“教编码 Agent 写自己代码”而出的技能，本技能的差异化在于官方一线维护、随框架版本同步，以及渐进式披露的文档工程与明确的开源许可证。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；已被 mcpmarket.com、awesomeskills.dev、claudeskills.info 等多个第三方技能目录网站收录，并被 Pydantic 官方文档站单独立页说明（pydantic.dev/docs/ai/overview/coding-agent-skills）。
9. 安装使用方式
- 官方插件市场（推荐）：
claude plugin install pydantic-ai@claude-plugins-official - 跨 Agent 通用：
npx skills add pydantic/skills --skill building-pydantic-ai-agents --agent claude-code（支持指定其他 Agent） - 手动安装：从仓库路径
pydantic_ai_slim/pydantic_ai/.agents/skills/building-pydantic-ai-agents/复制到本地.claude/skills/目录 - 安装后注意：无需重启，Claude Code 下次读取
.claude/skills/目录时即可识别；触发方式为对话中提及 Pydantic AI、代码导入pydantic_ai，或提出构建 Agent 相关需求时自动加载
10. 注意事项
- 技能明确自述不适用于纯 Pydantic 校验库场景（无 Agent 时），也不适用于 LangChain、LlamaIndex、CrewAI、AutoGen 等其他框架，误装到不相关项目里不会生效
- 使用该技能构建的 Agent 仍需自备 LLM 服务商 API Key（如
ANTHROPIC_API_KEY/OPENAI_API_KEY），这是 Pydantic AI 框架本身的运行前提，非该技能引入的额外成本 - OpenClaw、Hermes Agent 的兼容性未见官方材料点名确认，如需在这两个平台使用建议先行验证
- 上表 Stars/Forks 反映的是 Pydantic AI 框架主仓库的整体热度，技能本身作为框架内置资产，无法单独统计其安装或使用规模