用途:该技能用于为某个模块设计 API 或接口形态。它源自《A Philosophy of Software Design》中的“Design It Twice”方法,核心观点是第一个设计想法通常不是最好的,因此应生成多个截然不同的设计,再进行对比。
主要能力:
- 需求收集:在设计前梳理模块要解决的问题、调用方是谁(其他模块、外部用户、测试)、关键操作、约束条件(性能、兼容性、既有模式),以及哪些内容应隐藏在内部、哪些应对外暴露。
- 并行生成多套设计:同时启动 3 个以上子代理(使用 Task 工具),每个子代理被分配不同的约束,例如尽量减少方法数量(最多 1–3 个)、最大化灵活性、针对最常见场景优化、借鉴特定范式或库。每个子代理输出接口签名(类型/方法)、用法示例、内部隐藏的内容、该方案的取舍。
- 展示设计:逐个展示每套设计的接口签名、调用方的实际用法示例,以及内部隐藏的复杂度,让用户先理解每个方案再进行比较。
- 对比设计:从接口简洁性(方法更少、参数更简单)、通用与专用、实现效率(接口形态是否允许高效实现)、深度(小接口隐藏大量复杂度为好,大接口配薄实现为差)、正确使用与误用的难易度等角度,用文字而非表格讨论取舍,并指出方案分歧最大的地方。
- 综合:询问用户哪个设计最契合主要用例、是否有其他设计中的元素值得吸收,通常最佳设计会融合多个方案的洞见。
使用方式:先向用户提问“这个模块需要做什么?谁会使用它?”,收集需求后启动多个子代理并分配不同约束,逐个展示方案,再进行对比和综合讨论。
适用场景:需要设计 API、探索接口方案,或希望在动手实现前比较不同接口形态时。
限制与反模式:各子代理的设计必须截然不同,不能产出雷同方案;不能跳过对比环节,价值在于反差;本技能只关注接口形态,不实现代码;不依据实现工作量来评价设计。