SuperAPI AI 工具集

design-interface

编程与开发

查看项目

更新于 10-16 02:39

技能介绍

用途:依据“Design It Twice”思路,为避免第一直觉方案不佳,针对某个模块生成多个截然不同的接口设计并加以比较。适用于设计 API、探索接口选项等场景。

主要能力与工作流:

  1. 收集需求:明确模块要解决什么问题、调用方是谁(其他模块、外部用户、测试)、关键操作、约束(性能、兼容性、既有模式),以及哪些内容应隐藏、哪些应暴露。可询问“这个模块需要做什么?谁会使用它?”
  2. 生成设计:使用 Task 工具同时启动 3 个以上子代理,每个必须给出根本不同的方案。为各代理分配不同约束,例如:方法数量尽量少(1–3 个)、最大化灵活性、针对最常见场景优化、借鉴特定范式或库。每个方案输出接口签名、调用示例、内部隐藏的内容、该方案的取舍。
  3. 展示设计:依次展示每个方案的接口签名、实际调用示例和被隐藏的复杂度,便于用户逐个理解后再比较。
  4. 比较设计:从接口简洁性(方法更少、参数更简单)、通用与专用、实现效率、深度(小接口隐藏大复杂度为佳,大接口薄实现为劣)、易正确使用与易误用等角度,用文字讨论取舍而非表格,突出差异最大处。
  5. 综合:最佳设计常融合多个方案的洞见,可询问哪个设计最贴合主要用例、是否值得纳入其他设计的元素。

评价标准:接口简洁、通用性(避免过度泛化)、实现效率、深度、正确使用与误用难度。

限制与反模式:子代理不应产出相似设计;不可跳过比较;只关注接口形态,不做实现;不以实现工作量作为评价依据。

使用方式:在支持该技能的环境中调用本技能,按上述流程执行。具体安装命令、依赖信息在给定资料中暂未提供。