接口双方案

解决接口设计的“第一直觉陷阱”

在软件架构中，基于第一直觉设计的接口往往不是最优解。过早锁定一个平庸的 API 形状，会导致后期高昂的重构成本与调用方适配问题。本技能旨在打破这种“过早定型”的思维惯性，强制你在编码前先审视模块的多种可能形态。

核心工作流与设计哲学

本技能扮演资深架构师，严格遵循《A Philosophy of Software Design》中 "Design It Twice" 的理念。工作流分为五个关键步骤：

• 收集需求：明确模块边界、调用方、关键操作与约束，回答“做什么”与“谁在用”。
• 并行产出：生成 3 套以上差异最大化的方案。例如方案 A 追求 notify() 这种极简入口，方案 B 则引入 NotificationChannel 接口以换取最大灵活性。
• 逐一呈现：先展示每套方案的签名、调用示例及隐藏的复杂度，避免直接抛出对比表。
• 五维对比：从简洁性、通用性、实现效率、深度（小接口隐藏大复杂度）和易误用性进行散文式深度剖析。
• 综合建议：融合多套方案之长，输出最终的 InterfaceDesignSet 工件。

适用边界与注意点

本技能专注于接口的形状设计，不涉及具体业务逻辑的落地。它不会直接生成实现代码，也不以“实现成本高低”作为唯一的评价标准。如果你需要直接编写测试用例或业务代码，请将生成的接口方案交给下游的 tdd 或 implement 技能处理。