| 规则 | 路径命名、字段大小写、错误结构、版本头等 |
|---|---|
| 执行 | 提交与合并时扫描规范文件，输出定位信息 |
| 演进 | 规则集版本化，新约定先加规则再全量整改 |
Spectral 规则片段（YAML）
Spectral 规则片段（YAML）
rules:
operation-operationId:
severity: error # 每个操作必须有 operationId
path-kebab-case:
severity: warn # 路径使用 kebab-case
error-schema-required:
severity: error # 统一错误响应结构规则要有例外机制与负责人：一刀切的检查会被绕过，失去权威性。