用途:从 OpenAPI、JSON Schema、GraphQL Schema、接口清单、请求响应样例、版本和验证报告中提取 API Schema 校验候选,并进行可追溯比对,输出 ASV-## 发现。适合需要解释选择理由、适用约束、证据缺口和最小验证动作的场景;材料不完整但需交付受限初版时,也可明确 blocked 或 unassessed 边界。不适用于直接执行测试、生成无来源的契约或行为、替代完整测试策略,或替人类接受风险。
主要能力与使用方式:阅读 prompts/api-schema-validation.md,并提供目标、范围、材料、环境和已有证据。先完成 known、missing、conflicting、stale、out_of_scope、assumptions 六类输入审计。用 ASV-## 记录对象、前置条件、关注行为、来源证据和验证方法,保留影响/优先级、责任角色、关闭条件和证据状态。材料冲突、缺少约束或没有执行证据时,保留双方和待确认问题。默认输出 Markdown;表格、JSON 或 CSV 仅在用户明确需要或现有交付格式要求时使用。领域执行需先确认 OpenAPI/JSON Schema/GraphQL 及具体版本或 dialect、operation/方向、内容类型、引用根与解析上下文;版本未知时暂停依赖版本的判断。交付 dialect、引用解析状态、样例×约束判定表;“缺失”和“值为 null”须分别判定,不能由 required 推导非空。
限制:不执行测试,不假设未提供的规则、版本、阈值、数据或响应,不把候选数量当作覆盖证明。文件存在、名称匹配、设计声明或 Eval 配置不等于真实执行证据。未知项标为 unassessed、blocked 或待确认,不用常识补齐。不修改需求、代码、测试资产或目标系统。回归时读取 evals/eval.yaml 和匹配用例;触发验证使用 evals/trigger-prompts.csv 和 evals/local-rules.json;缺少 skill.selection 证据时报告 BLOCKED。