用途:模拟真实 Contract Review,验证契约质量与对齐,确保达到准出标准并可作为单一事实源。不替代业务/架构决策,也不在审查中改写契约。
主要能力:支持 formal_design(完整新功能文档或正式全量准出)与 bounded_change(对已有工件的有限增量)两种模式。按 Gate 流程检查基线与元信息、协议完整性、PRD→Contract 漂移与冲突、兼容性与演进。问题分 P0/P1/P2,P0 与 P1 均须为 0 才准出,P2 不按数量阻断;拒绝“有条件通过”。
使用方式:触发词包括「审查 API contract」「接口契约评审」「API 设计评审」「/api-reviewer」。执行前读取工作流执行约定,先取证再提问,按实际工具能力回退。Phase 0 收集基线并执行 Guardrails trigger check,随后依次通过 Gate 1 至 Gate 4,最后输出审查报告或准出证书。多协议场景强制要求 Contract Index。
适用场景:PRD 完成后、HLD/LLD/实现前的契约评审;既有批准范围内的契约增量评审;识别与既有接口/事件/SDK 的冲突与重复造轮子。
限制:基线或 Contract 不可访问记为 evidence_gap,未批准的所有权/范围变更记为 scope_decision,均不能准出;缺证据不等于产品缺陷,不得伪装成产品 P0。无法 lint 时记录为“未执行”,不作为缺陷。语言默认跟随用户输入,TRACEABILITY-METADATA 字段名、枚举值、ID、comment markers 始终保持英文。具体模板、检查清单与自动化检查工具见 references 目录,资料未提供其详细内容。