用途：为模型设计并校验工具定义，让模型更容易选择安全、符合意图的调用，而非模糊或破坏性的替代方案。适用于新增或修改函数调用、MCP、插件或内部智能体工具，拆分过载的 API 操作，减少选错工具、参数畸形或编造字段，并记录授权、确认、幂等与错误行为。
主要能力：产出工具边界决策与重叠分析；面向模型的名称与描述，含明确的使用与不使用条件；带约束、示例和未知字段策略的参数 schema；副作用、确认、授权、幂等、超时与错误契约；正向、边界、对抗与工具选择测试；校验结果及提供方特定限制。
使用方式：每个工具对应一个连贯用户意图，按权限、副作用或必填字段拆分；采用稳定的动词开头名称；描述说明做什么、何时调用、何时不调用、改变什么状态；参数从用户意图出发而非照搬后端 SDK，仅必填必要字段，封闭选项用枚举，设置数值与长度边界，说明格式与单位；运行时支持时拒绝未知字段；身份、授权范围与租户上下文保留在服务端，不让模型提供密钥。执行语义在 JSON 之外定义：只读或变更、确认级别、幂等键、重试安全、超时、部分成功与补偿动作。返回紧凑结构化结果与稳定机器可读错误码。接线前运行 python3 scripts/validate_tool_schema.py tool.json --strict；结构错误始终失败，严格模式还会因自由命令执行、调用方控制权限标志、凭据参数、任意 URL/路径、宽松未知字段、缺失有用边界等审查发现而失败。structurally_valid 仅描述 JSON 形状，strict_pass: true 也不构成语义安全、授权、沙箱、提供方兼容或实现认证。
限制：授权必须在工具实现中强制执行，不能依赖模型描述作为安全边界；购买、消息、部署、删除、权限变更等重大变更需显式确认；除非用例与沙箱要求，不暴露密钥参数、原始凭据、无限制 shell 命令或任意 URL 与文件路径；优先使用允许列表、限定标识符、试运行、幂等键与可逆操作；工具输出放回模型上下文前视为不可信输入。需用目标提供方而非仅内置校验器验证 schema，并确认必填字段、枚举可达、数组项形状与未知字段处理一致。