---

name: tool-use-guardian description: "免费 — 智能工具调用可靠性包装器。监控、重试、修复并从工具故障中学习。自动从截断的 JSON、超时、速率限制和链中断故障中恢复。" category: reliability risk: safe source: community date_added: "2026-03-13" author: christopherlhammer11-ai tags: [reliability, tool-use, error-handling, retries, recovery, agent-infrastructure] tools: [claude, cursor, codex, gemini, copilot, windsurf, antigravity]

工具使用守护者

概述

每个 AI 智能体都需要的可靠性包装器。监控工具调用、自动重试失败、修复截断响应，并学习哪些工具不可靠——让你永远不会丢失思维链。

永久免费。由 Genesis Agent Marketplace 构建。

安装

npx skills add christopherlhammer11-ai/tool-use-guardian

何时使用此技能

• 当工具调用返回截断或格式错误的 JSON 时使用
• 当 API 在智能体执行任务中途超时或触发速率限制时使用
• 当多步骤链在中途断裂时使用
• 当你需要自动重试逻辑而不想自己编写时使用
• 用于任何依赖外部工具可靠性的智能体工作流

工作原理

步骤 1：调用前验证

在每次工具调用之前，Guardian 验证：

• 必需参数存在且类型正确
• 该工具未因之前的故障被标记为不可靠
• 请求大小在已知限制范围内

步骤 2：故障分类

当工具调用失败时，Guardian 将故障分为 9 个类别：

| 故障类型 | 恢复操作 | |---|---| | JSON 截断 | 使用分页或更小的块重新获取 | | API 超时 | 用更简单的请求重试一次，然后分解 | | 速率限制 (429) | 指数退避，最多重试 3 次 | | 认证过期 | 标记需要用户干预 | | 链中断 | 从最后一个成功检查点恢复 | | 伪装成功的错误 | 检测伪装为成功的 {"error": "..."} | | Schema 不匹配 | 尝试自动转换，如有损失则警告 | | 网络故障 | 带抖动重试，最多 2 次 | | 未知错误 | 记录完整上下文，上报给用户 |

步骤 3：链保护

对于多步骤工具链，Guardian 维护检查点。如果第 7 步中的第 4 步失败，它从第 4 步恢复——永远不会从头开始。

步骤 4：学习

Guardian 追踪每个工具的故障模式。在同类型故障发生 3 次以上后，它将该工具标记为不可靠并建议替代方案。

最佳实践

• 让 Guardian 自动包装所有外部工具调用
• 查看 Guardian 的可靠性报告以识别不稳定的工具
• 对长链使用检查点恢复
• 不要对受速率限制的 API 禁用重试逻辑
• 不要忽略重复的故障警告

相关技能

• @recallmax - 长上下文记忆增强（同样来自 Genesis Marketplace 的免费技能）

链接

• 仓库： https://github.com/christopherlhammer11-ai/tool-use-guardian
• 市场： https://genesis-node-api.vercel.app
• 浏览技能： https://genesis-marketplace.vercel.app

限制

• 仅在任务明确匹配上述描述范围时使用此技能。
• 不要将输出视为特定环境验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停下来要求澄清。