为 AI Agent 设计 Schema-First 能力契约

文章主张当 AI Agent 能调用生产系统时，Agent 与能力之间的契约比提示词更重要。作者提出 schema-first 能力设计：对 create_invoice、deploy_service 等真实操作定义机器可读 schema，涵盖输入字段、类型与约束、输出结构、错误变体，并让 CLI、HTTP API、Agent 工具都从该 schema 派生。理由是 LLM 不具备类型安全，会漏填必填字段、编造字段或传错类型，若在应用深处才校验，问题往往在产生部分副作用后才被发现；schema 感知的运行时可在执行前校验输入。

AI推荐理由 提出以机器可读 schema 作为 agent 与生产系统之间契约的工程实践，指出 LLM 非类型安全（漏字段、编造字段、类型错误）导致副作用后才暴露问题，主张在运行时前置校验。属于可落地的 agent 工具设计方法，但为个人博客经验分享，无实测数据或案例验证。