← 返回 Skills 市场
Pydantic Ai Common Pitfalls
作者
Kevin Anderson
· GitHub ↗
· v1.0.1
· MIT-0
169
总下载
0
收藏
1
当前安装
2
版本数
在 OpenClaw 中安装
/install pydantic-ai-common-pitfalls
功能描述
Avoid common mistakes and debug issues in PydanticAI agents. Use when encountering errors, unexpected behavior, or when reviewing agent implementations.
安全使用建议
This is a documentation-only skill that provides code examples and debugging tips for PydanticAI agents and appears internally consistent. It does not install code or request secrets. Before running any example code you copy from the doc, review it and only set required environment variables (e.g., OPENAI_API_KEY) in a safe manner; avoid pasting sensitive credentials into public or unknown places. If you plan to execute code from other sources referenced by the examples, inspect those sources first.
功能分析
Type: OpenClaw Skill
Name: pydantic-ai-common-pitfalls
Version: 1.0.1
The skill bundle is a purely educational guide and reference for debugging PydanticAI implementations. It contains documentation and code snippets (SKILL.md) illustrating common developer errors, such as incorrect tool decorators, dependency mismatches, and async/sync mistakes, along with their respective fixes. No malicious code, data exfiltration, or harmful prompt injection attempts were found.
能力标签
能力评估
Purpose & Capability
The name/description (PydanticAI pitfalls and debugging) matches the SKILL.md content: examples, fixes, and guidance for agent/tool usage. No unrelated credentials, binaries, or installs are requested.
Instruction Scope
SKILL.md contains code examples, explanations, and debugging advice for PydanticAI agents. It does not instruct the agent to read arbitrary files, exfiltrate data, or call external endpoints beyond noting common environment variables (e.g., OPENAI_API_KEY) relevant to model usage.
Install Mechanism
No install spec and no code files — instruction-only content. Nothing will be downloaded or written to disk by the skill itself.
Credentials
No required environment variables are declared. The doc references OPENAI_API_KEY and model strings only in the expected context of configuring model access — this is proportionate to the guidance being given.
Persistence & Privilege
Skill is not always-enabled and is user-invocable. It does not request persistent system presence or modify other skills; autonomy settings are default and appropriate for an instruction-only helper.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install pydantic-ai-common-pitfalls - 安装完成后，直接呼叫该 Skill 的名称或使用
/pydantic-ai-common-pitfalls触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
- Added a new "Debugging Tips" section detailing practical troubleshooting steps to follow when failures are ambiguous or unclear.
- The new section includes a prioritized checklist ("Gates") for systematically diagnosing agent misbehavior.
- All other existing guidance, patterns, and fixes remain unchanged.
v1.0.0
Initial release: A reference guide to common mistakes and solutions for PydanticAI agent development.
- Documents decorator errors with `@agent.tool` and `@agent.tool_plain`, showing proper and improper usage of `RunContext`.
- Explains correct and incorrect patterns for tool registration, especially when using raw functions in `Agent(tools=[...])`.
- Highlights dependency type mismatches, output type validation issues, async/sync mistakes, and streaming pitfalls.
- Outlines frequent model configuration errors (e.g., API key issues, invalid model string).
- Provides debugging tips, including tracing, capturing messages, and inspecting responses.
- Includes a table of common error messages with causes and fixes.
元数据
常见问题
Pydantic Ai Common Pitfalls 是什么？
Avoid common mistakes and debug issues in PydanticAI agents. Use when encountering errors, unexpected behavior, or when reviewing agent implementations. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 169 次。
如何安装 Pydantic Ai Common Pitfalls？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install pydantic-ai-common-pitfalls」即可一键安装，无需额外配置。
Pydantic Ai Common Pitfalls 是免费的吗？
是的，Pydantic Ai Common Pitfalls 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Pydantic Ai Common Pitfalls 支持哪些平台？
Pydantic Ai Common Pitfalls 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Pydantic Ai Common Pitfalls？
由 Kevin Anderson（@anderskev）开发并维护，当前版本 v1.0.1。
推荐 Skills