结构化提示词里给示例字段加校验规则，响应 schema 和 sample 终于不打架了
将示例字段的校验规则直接写入结构化提示词，强制模型在生成响应示例前逐字段对照 schema 约束，可根治 API 文档中示例与 schema 不一致的问题。通过设置 field_validation_rules 和 validation_check 输出结构，把校验动作显式化，实测可将一致性提升至 100%。
标签: #API文档校验
共 2 篇文章
给接口文档生成流程加一道校验，没写文档的接口别想进测试环境
后端联调最烦接口文档缺字段，这本质是流程问题。解决方案是在CI/CD流水线中加入文档校验，与lint和单测同级，不合格则构建失败。具体通过ArchUnit在编译期扫描源码，检查Controller方法的@Operation注解及入参、返回值对象的@Schema注解是否完整，并可在集成测试阶段对生成的OpenAPI文档做二次校验。