Menu
深度分析 IDL diff——字段增删改、frozen 状态、向后兼容性、下游受影响调用方。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | idl-diff-analyzer |
| description | 深度分析 IDL diff——字段增删改、frozen 状态、向后兼容性、下游受影响调用方。 |
| allowed-tools | Read, Bash, Grep, Glob |
原文 §8.3 服务治理类。是
api-contract-consistency-validator的深度补充。
{
"idl_repo_path": "...",
"base": "...",
"head": "..."
}
| 维度 | 检查 |
|---|---|
| 新增字段 | 必须 optional 或带默认值 |
| 删除字段 | 必须先标 deprecated ≥ 1 个版本，且确认下游无引用 |
| 类型变更 | 视为破坏性变更，必须新增 field_v2 并保留 field_v1 |
| frozen 字段 | 任何修改都阻塞 |
| 注释变更 | 仅信息提示 |
| 默认值变更 | 视为破坏性（行为可能改变） |
.service-matrix/dependencies.yaml 找所有依赖此 IDL 的服务=== 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 变更"小节时调用提取字段列表校验业务代码与 IDL 契约同步、字段冻结状态是否被破坏。作为 8 维度 code review 的"契约一致"维度，可被 design-checker / code-review-preparer 调用，也可独立运行。
聚合 8 维度 review Agent 的产出，生成统一的 review 报告并写入 reviews/{ts}.md。
当 context/ 下新增/删除文件时，自动更新对应层级的 INDEX.md，避免"孤儿文件"。
按 templates/detail-design.md 模板撰写详细设计文档，包括数据模型、IDL 变更、接口设计、决策、错误处理、监控、灰度等。
运维操作中心（Operations Center）通用适配器——为团队的运营/运维操作（开关、灰度、限流、降级）提供统一调用约定。具体实现按团队接入。
DevOps CLI 通用适配器——把团队的部署/构建/发布命令包装成一致的高层接口。具体实现按团队接入。