pi-tool-repair
自动修复LLM工具调用中的常见错误
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-tool-repair。 它的用途是：自动修复LLM工具调用中的常见错误 完整的 Skill 内容见：https://321skill.com/skills/pi-tool-repair/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“调用天气查询工具，参数是 city: '北京'。” 如果LLM错误地返回了 `{city: null}` 或 `{cityName: '北京'}`，pi-tool-repair 会自动将其修复为正确的字段名和值 `{city: '北京'}`，确保工具能成功执行。
介绍
pi-tool-repair 是一个针对 pi 框架的验证-修复扩展，旨在解决大型语言模型（LLM）在调用工具时频繁出现的结构化错误。这些问题包括字段值为 null、数组被错误地字符串化、字段名拼写错误以及锚点信息泄露等，它们常常导致工具调用失败或产生非预期结果。
该扩展的使用方式非常简单直接。开发者只需将其作为中间件或插件集成到现有的 pi 工具调用流程中。在 LLM 生成工具调用参数后、实际执行工具前，pi-tool-repair 会自动介入，对参数进行验证，并尝试修复检测到的常见错误，然后将修正后的参数传递给工具执行，从而提升调用成功率。
它非常适合依赖 LLM 进行自动化工具调用的开发者、AI 应用工程师以及任何使用 pi 框架构建 Agent 或工作流的团队。当你的应用需要 LLM 稳定、可靠地调用外部 API 或内部函数时，这个工具能显著减少因参数格式问题导致的故障。
建议在开发测试阶段就引入此工具，以便尽早发现和适应 LLM 的输出模式。需要注意的是，它主要修复的是格式和结构层面的浅层错误，对于参数值本身的逻辑错误或语义错误无能为力。在性能要求极高的场景，需评估其验证和修复步骤带来的微小延迟是否可接受。
核心特点
与同类工具相比，pi-tool-repair 深度集成于 pi 框架的工具调用生命周期，在错误发生前进行拦截和修复，而非事后处理。它专门针对 LLM 工具调用中最高频的几类结构化错误（如字符串化数组、锚点泄露）设计了精确的修复规则，而非通用的数据清洗。
注意事项
无法修复参数值的深层逻辑错误或语义错误，仅处理格式和结构问题。
常见问题
pi-tool-repair 支持哪些 LLM？
它与 LLM 无关，专注于修复 pi 框架下任何 LLM 产生的工具调用参数。
会影响工具调用的速度吗？
会引入极短的验证和修复时间，对于绝大多数应用来说延迟可忽略不计。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-tool-repair/raw/index.md 读取 pi-tool-repair 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-tool-repair/raw/index.md（查看排版版本）