idl-diff-analyzer

name	idl-diff-analyzer
description	深度分析 IDL diff——字段增删改、frozen 状态、向后兼容性、下游受影响调用方。
allowed-tools	Read, Bash, Grep, Glob

Skill: idl-diff-analyzer

原文 §8.3 服务治理类。是 api-contract-consistency-validator 的深度补充。

输入

{
  "idl_repo_path": "...",
  "base": "...",
  "head": "..."
}

分析维度

维度	检查
新增字段	必须 optional 或带默认值
删除字段	必须先标 deprecated ≥ 1 个版本，且确认下游无引用
类型变更	视为破坏性变更，必须新增 field_v2 并保留 field_v1
frozen 字段	任何修改都阻塞
注释变更	仅信息提示
默认值变更	视为破坏性（行为可能改变）

下游影响

• 扫描 .service-matrix/dependencies.yaml 找所有依赖此 IDL 的服务
• 在业务仓里 grep 字段名出现位置
• 输出"被影响的调用点"清单

输出

=== IDL Diff Analysis: coupon.jce ===

新增字段：
  ✓ tag_rule_json (optional, default="")          — 兼容
  ✓ estimated_users (optional, default=0)         — 兼容

删除/修改：
  无

frozen 字段：
  user_ids — 未变更 ✓

下游影响：
  - couponcenter (本仓): 直接受益方
  - 无其他下游

协作

• 被 api-contract-consistency-validator Skill 调用做 K3/K5 详检
• 被 detail-design-doc-writer Skill 在写"IDL 变更"小节时调用提取字段列表