用途:在评审 PR 中新增或扩展共享接口层(API、IPC 通道、端点、参数、类型、配置、架构扩展点)时,按“根结果或不变量 → 归一化需求 → 归属层 → 契约 → 消费者”的因果链先行审查,再评估实现质量。
主要能力与工作流:
- 重建需求:列出每个新暴露面及其被消费的具体维度,追踪现有与关联消费者到用户结果、业务规则或系统不变量,不依赖 PR 描述。
- 审计消费者合法性:区分正当、补偿性(因缺正确能力而绕过)、历史遗留、错位四类消费者。解析、重试、顺序控制、重复状态、先查后写、跨层访问均视为补偿信号。
- 归一化相关需求:剥离命名与历史格式,按结果、事实来源、归属、事务、安全、生命周期聚类;真正差异才保留独立契约,优先稳定核心加薄适配器。
- 证据分类:直接、已承诺、架构性、无支撑臆测。直接消费只证明压力,不证明位置或形态。
- 架构性需求测试:无正当现有消费者时须同时满足五条——具体消费者类或扩展场景、归属层与受保护不变量、因果性遗漏代价、为何须先于首位消费者存在、保护该不变量所需的最小稳定机制。
- 检查职责与重叠:按归属而非代码行数放置行为,安全、权限、事务、不变量与共享策略集中;按语义、归属、权限、暴露、原子性、生命周期、失败模型与成本比较契约。
- 先决策后评审:每个暴露面选保留、收窄、拆分、合并、替换、推迟或移除之一,报告根结果、证据、消费者合法性、本质差异、归属、替代方案与决定,仅对存留者评审实现质量。
限制:资料未提供安装方式、命令、平台或收费信息。技能明确反对以“接口干净”“有消费者”“未来可能用到”“技术约束”“架构师决定”等理由豁免需求审查;测试不创造需求,附加式契约有长期成本。