菜单
深度分析 IDL diff——字段增删改、frozen 状态、向后兼容性、下游受影响调用方。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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 通用适配器——把团队的部署/构建/发布命令包装成一致的高层接口。具体实现按团队接入。