LLM 工具 Schema 审查器

解决什么问题

在 LLM 工具调用里，很多 Schema 只在文档里看起来完整，真正进入执行链路后才发现：工具名不够清晰、必填项没标清楚、字符串和数组没有边界、嵌套过深、重试不幂等，甚至一些会改变外部状态的操作缺少前置条件。这类问题往往不会导致直接报错，但会让模型在错误时机调用工具，或者让执行端拒绝请求，最终表现为不稳定或不可靠的 Agent 行为。

这个技能用于审查已经提供的 JSON Schema 与执行契约，而不是替你补充业务规则。它关注定义本身是否可执行、可验证、可迁移。

核心审查能力

技能会围绕以下关键点逐项检查：

• 工具名是否是 动词-名词 结构，description 是否明确说明何时应该调用、何时不应该调用。
• required 是否显式声明，字符串复用是否应拆分为 enum 或类型化对象。
• string 长度、数值范围、数组大小、格式约束、additionalProperties 是否被明确限制。
• 对象嵌套是否保持浅层，是否避免依赖单一提供商专有的 JSON Schema 特性。
• 标识符与展示文本是否分离，时区、单位、货币、编码是否有定义。
• 校验错误是否能以可修复的形式表达，同时不泄露内部实现或敏感信息。
• 只读操作与变更操作是否区分，破坏性或外部可见动作是否要求确认。
• 重试场景是否定义 幂等性 与 去重 策略。

输出结果

审查完成后，会按严重程度输出发现项，并给出修正后的 Schema、执行前置条件、错误示例，以及覆盖合法、缺字段、边界、畸形、重复与未授权调用的契约测试。

适用边界

技能不会编造缺失的业务约束。它会指出当前定义缺少边界或不可执行的部分，但不负责决定这些边界应该是什么。你需要结合真实业务规则补全具体的取值范围与前置条件。