api-and-interface-design

Overview

接口是合同 —— 设计错误的接口改起来贵 10x(Hyrum's Law:用户开始依赖你所有行为,即使是 bug)。先设计 contract,再实现,再集成。

omo 没有专门的接口设计 skill —— frontend-ui-engineering 偏 UI,api-and-interface-design 偏 backend 契约。这个 skill 填补。

When to Use

Use when:

• 设计 REST / GraphQL / gRPC / RPC endpoint
• 定义 module / package / library 的 public surface
• 跨语言 / 跨团队的 type contract
• 发布 SDK / 公共 API
• 重构现有接口(breaking change)