SuperAPI AI 工具集

design-an-interface

编程与开发

查看项目

更新于 10-16 09:45

技能介绍

用途:在动手实现之前,为某个模块生成多个根本不同的接口设计并加以比较。理念来自《A Philosophy of Software Design》的“Design It Twice”:第一个想法往往不是最好的。

主要能力与流程:

  1. 收集需求:先弄清模块解决什么问题、调用者是谁、关键操作、约束(性能、兼容性、既有模式),以及什么应隐藏、什么应暴露。
  2. 并行生成设计:用 Task tool 同时启动 3 个以上子代理,每个强制采用不同约束,例如最少方法数(1-3 个)、最大灵活性、优化最常见用例、借鉴某范式或库。每个设计需输出接口签名、用法示例、内部隐藏的内容和取舍。
  3. 依次展示各设计,让使用者先分别理解再比较。
  4. 比较维度:接口简洁度、通用与专用、实现效率、深度(小接口隐藏大量复杂度为佳,大接口配薄实现应避免)、易于正确使用与易于误用。用叙述而非表格讨论取舍,突出分歧最大的地方。
  5. 综合:询问哪个设计最契合主要用例、其他设计是否有值得合并的元素。

适用场景:设计 API、探索接口选项、比较模块形状,或用户提到“design it twice”时。

限制与注意事项:不要让子代理产出相似设计,必须强制根本差异;不要跳过比较步骤;不要在此阶段实现,只讨论接口形态;不要以实现工作量作为评价标准。

其他信息(如具体平台要求、安装方式或费用)暂未提供。