Agent Skills
› pydantic/pydantic-ai
pydantic/pydantic-ai
GitHub用于将新发布的语言或图像生成模型接入pydantic-ai框架。通过验证提供商端点、配置能力标志、更新适配器与测试，处理SDK滞后及网关约定，确保新模型ID被系统正确识别与支持。
安装全部 Skills
npx skills add pydantic/pydantic-ai --all -g -y
集合内 Skills (29)
用于将新发布的语言或图像生成模型接入pydantic-ai框架。通过验证提供商端点、配置能力标志、更新适配器与测试，处理SDK滞后及网关约定，确保新模型ID被系统正确识别与支持。
需要支持提供商新发布的模型ID
为新模型添加适配器和测试
处理模型能力标志配置
npx skills add pydantic/pydantic-ai --skill add-new-model -g -y
指导在 Pydantic AI 中新增跨提供商 API 功能（如缓存、工具调用等）。核心规则是先复用现有抽象而非新建，确保接口一致性。
需要添加新的提供商 API 能力
设计 Provider 特性接入逻辑
npx skills add pydantic/pydantic-ai --skill adding-a-provider-api-feature -g -y
用于接手已有PR，从关联Issue和现有审查线程中自动补全issue-brief.md与pr-decisions.md上下文文件。适用于未通过初始化命令创建的分支，帮助快速恢复本地工作语境并回溯决策依据。
接手他人或自己的已有PR
发现分支缺少上下文文件
需要回溯已解决的审查决策
npx skills add pydantic/pydantic-ai --skill adopt-pr -g -y
管理分支本地持久化PR状态，维护issue简报、决策日志与会话交接。确保会话启动时同步上下文，处理非信任源文本安全，并协调多智能体协作以避免工作冲突。
需要读取或更新分支相关的issue简报和决策日志
进行跨会话的工作交接或接管其他智能体的任务
npx skills add pydantic/pydantic-ai --skill branch-context -g -y
评估并补全仅修复局部症状的 PR，确保覆盖集成契约、测试和文档。通过子代理进行规范研究、代码路径映射和历史决策分析，将窄贡献转化为可维护的完整变更。
PR 仅修复表面错误
需验证是否遗漏集成面或破坏向后兼容
npx skills add pydantic/pydantic-ai --skill complete-partial-pr -g -y
作为文档一致性审查关卡，验证 Pydantic AI Harness 能力变更时代码、README 与统一文档的同步性。检查内容是否更新、片段可运行、链接规范及文档间一致性，仅报告问题不修改。
PR 合并前的最终文档审查
涉及 pydantic-ai-harness 功能或文档的变更
npx skills add pydantic/pydantic-ai --skill docs-parity-reviewer -g -y
用于在PR稳定后发现非范围但值得修复的Bug或改进时，通过去重、确认和创建GitHub Issue来记录上下文，并记录决策日志，确保不干扰当前PR。
发现超出当前PR范围的实质性Bug或改进点
需要为未来工作创建带上下文的Issue
npx skills add pydantic/pydantic-ai --skill file-followup-issue -g -y
优化AI回复结构以适配ADHD用户，要求直接给出结果、使用结构化提问、禁止冗余铺垫，提升信息获取效率。
需要向用户请求决策或确认时
回复任何类型的消息（包括编码、调试、闲聊）
npx skills add pydantic/pydantic-ai --skill i-have-adhd -g -y
该技能用于从新问题或 GitHub Issue 开始工作，通过解析输入、研究代码库、编写分支上下文文件并规划修复方案，最终创建初始 PR。旨在为新任务建立标准化起点。
用户需要开始处理新的 GitHub Issue
用户希望基于问题描述在独立分支上制定修复计划
初始化新项目的工作流
npx skills add pydantic/pydantic-ai --skill initialize-worktree -g -y
在代码推送前进行本地审查，利用模型订阅独立评估变更风险。支持按工作区分解差异、分发子代理并行审查，并依据既定范围、豁免和预算约束执行，旨在低成本捕获潜在问题。
需要执行推送前审查时
检测到待审查的代码变更差异
npx skills add pydantic/pydantic-ai --skill pre-push-review -g -y
指导 Agent 完成 PR 创建、代码推送、CI 监控及评论处理的全流程。包含模型选择策略、合并标准（Merge Bar）及元数据更新规范，确保 PR 符合审查要求并顺利合入。
用户需要提交代码或创建 Pull Request
PR 已创建但需推进 CI 状态或处理评论
需要检查 PR 是否满足合并条件
npx skills add pydantic/pydantic-ai --skill pushing-commits-to-the-repo -g -y
同步 GitHub Issue 最新状态并更新简报。当用户指示检查新评论或 Issue 变更时触发，通过对比指纹和元数据检测范围、约束等语义变化，仅在有实质影响时更新 brief.md，保持简报稳定。
用户要求检查 Issue 最新评论
用户告知 Issue 已更新需重新读取
用户询问上游 Issue 是否有变动
npx skills add pydantic/pydantic-ai --skill refresh-issue-brief -g -y
用于处理当前分支PR中的未解决评论，通过获取上下文、复现缺陷及评估影响范围，决定修复、拒绝或升级，确保变更符合规范且不扩大影响。
用户请求处理PR评审意见
需要清理PR中遗留的待办评论
npx skills add pydantic/pydantic-ai --skill address-feedback -g -y
管理分支级持久化PR状态，包括问题简报、决策日志与会话交接。确保会话间上下文一致性，防止跨代理误读，提升协作效率与安全性。
开始新编码会话
需要读取或更新分支上下文
npx skills add pydantic/pydantic-ai --skill branch-context -g -y
在推送代码前进行本地代码审查，模拟人工评审标准，检查变更内容并返回可执行的修复建议。
首次推送分支前
向已有PR的分支推送新代码前
npx skills add pydantic/pydantic-ai --skill pre-push-review -g -y
提供Pytest VCR工作流，用于录制、重写和调试HTTP测试磁带。支持验证回放、解析YAML内容及管理快照断言，确保测试稳定可靠。
录制或重录VCR磁带
验证磁带回放
检查请求响应体
npx skills add pydantic/pydantic-ai --skill testing-skill -g -y
提供基于 Pydantic AI 构建生产级 AI Agent 的模式、架构指导和代码示例，涵盖工具集成、结构化输出、流式处理、多智能体协作及测试等核心功能。
用户提及构建 AI Agent 或 LLM 应用
代码导入 pydantic_ai 或引用相关类
需要为 Agent 添加工具、能力或工作区
涉及 Agent 测试、流式输出或多智能体模式
npx skills add pydantic/pydantic-ai --skill building-pydantic-ai-agents -g -y
指导将Python Agno应用迁移至Pydantic AI，保留可观测行为。涵盖核心Agent、图流程及Harness的选择策略，强调最小化目标路径和基础设施隔离，确保平滑过渡。
代码中导入agno或依赖Agno特性
需要将Agno代理/工作流迁移到Pydantic AI
npx skills add pydantic/pydantic-ai --skill migrating-agno-to-pydantic-ai -g -y
指导将Python应用从Claude Agent SDK迁移至Pydantic AI，保留可观测行为。适用于代码导入claude_agent_sdk或依赖其代理循环、工具及权限的场景。
代码中导入 claude_agent_sdk
依赖 Claude Code 的代理循环、会话、内置工具或子代理
npx skills add pydantic/pydantic-ai --skill migrating-claude-agent-sdk-to-pydantic-ai -g -y
指导将Google ADK应用迁移至Pydantic AI，涵盖状态、会话、工作流等核心功能重构，确保行为一致性与安全隔离。
需要迁移 Google ADK 到 Pydantic AI
重构 Agent 架构以使用 Pydantic AI
npx skills add pydantic/pydantic-ai --skill migrating-google-adk-to-pydantic-ai -g -y
指导将Python LangChain、LangGraph及Deep Agents应用迁移至Pydantic AI生态。涵盖Agent、链、图工作流及Harness特性的行为保留与代码重构，确保契约兼容。
需要将LangChain或LangGraph项目迁移到Pydantic AI
涉及Deep Agents到Pydantic AI Harness的转换
npx skills add pydantic/pydantic-ai --skill migrating-langchain-to-pydantic-ai -g -y
将 TypeScript Mastra 应用迁移至 Python Pydantic AI。通过追踪调用路径、分离契约并选择最小目标组件，保留可观察行为，实现 Agent、工作流及工具的功能等效替换。
需要将基于 Mastra 的 TypeScript 代码迁移到 Python
项目中使用了 @mastra/* 包或依赖 Mastra 代理、工具、工作流等核心功能
npx skills add pydantic/pydantic-ai --skill migrating-mastra-to-pydantic-ai -g -y
指导将基于 OpenAI Agents SDK 的 Python 应用迁移至 Pydantic AI。涵盖 Agent、Runner、工具、会话、流式处理等核心组件的行为等价重构，强调保留调用者可见行为并建立确定性基线。
需要将 OpenAI Agents SDK 代码迁移到 Pydantic AI
涉及 Agent 运行时逻辑的重构或框架升级
npx skills add pydantic/pydantic-ai --skill migrating-openai-agents-sdk-to-pydantic-ai -g -y
指导将基于 TypeScript Pi 框架的编码代理应用迁移至 Python Pydantic AI。涵盖追踪调用路径、分析扩展职责、映射能力契约及验证切换，确保行为一致并保留宿主基础设施。
需要将 TypeScript Pi 应用迁移到 Python
代码中导入 @earendil-works/pi-* 或调用 createAgentSession
重构 Agent 核心逻辑以使用 Pydantic AI
npx skills add pydantic/pydantic-ai --skill migrating-pi-to-pydantic-ai -g -y
指导将 TypeScript Vercel AI SDK 或 Eve 应用迁移至 Python Pydantic AI。通过追踪行为、分类合约并选择最小目标实现，确保可观测行为一致，处理 Agent、流式传输及持久化等核心功能。
需要迁移 Vercel AI SDK 代码到 Python
需要迁移 Eve 应用到 Pydantic AI
npx skills add pydantic/pydantic-ai --skill migrating-vercel-ai-sdk-and-eve-to-pydantic-ai -g -y
用于在接手或续接现有PR时，自动收集PR元数据、关联Issue及代码变更，生成issue-brief.md和pr-decisions.md以建立分支上下文。
接手他人未完善的PR
自己的PR缺少分支上下文文件
需要回溯已存在PR的决策记录
npx skills add pydantic/pydantic-ai --skill adopt-pr -g -y
管理分支持久化状态，包括问题简报、决策日志和会话交接。启动时读取上下文，工作中自动记录非平凡决策，按需生成交接文件，确保跨会话信息连续性。
开始新的编码会话
做出非显而易见的技术决策
用户请求或明确进行会话切换
npx skills add pydantic/pydantic-ai --skill branch-context -g -y
指导在PR或推送代码后，自动标记PR、监控CI状态、处理审查意见并升级设计决策，直到CI通过且无未决评论。
打开PR时
向仓库推送提交时
npx skills add pydantic/pydantic-ai --skill pushing-commits-to-the-repo -g -y
针对大型新功能PR的独立审计技能，通过先研究外部API和协议构建理想测试集，再与实现对比以发现行为完整性和运维健壮性缺口，提供基于证据的审查项。
收到包含新API、新模态或新子系统的大型功能PR
需要脱离代码细节的行为级独立性评估
npx skills add pydantic/pydantic-ai --skill poweruser-feature-audit -g -y
