SuperAPI AI 工具集

design-an-interface

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:为某个模块设计接口(API)时,避免第一直觉方案,先并行生成多个差异显著的接口设计,再进行比较与综合,用于设计 API、探索接口方向。

主要能力与流程:

  1. 收集需求:明确模块解决什么问题、调用方是谁、关键操作、约束(性能、兼容性、既有模式)、隐藏与暴露的边界。
  2. 并行生成设计:用 Task 工具同时启动 3 个以上子代理,每个产出根本不同的方案,并分配不同约束,如最少方法数(1-3 个)、最大灵活性、优化最常见场景、借鉴某范式或库。每个方案输出接口签名、使用示例、内部隐藏内容、取舍。
  3. 展示设计:逐个展示接口签名、调用示例、隐藏的复杂度,便于用户逐一理解。
  4. 对比设计:从接口简洁度、通用与专用、实现效率、模块深度(小接口隐藏大复杂度)、易用与易误用等维度比较,用文字而非表格讨论取舍,突出分歧点。
  5. 综合:询问哪个方案最贴合主要用例,是否融合其他方案的要素。

评价标准:接口简洁(方法少、参数简单)、通用性(兼顾未来用例但避免过度泛化)、实现效率、模块深度(小接口隐藏大复杂度为佳,大接口薄实现为差)。

限制与反模式:不要让子代理产出相似设计;不要跳过对比,价值在于反差;不要实现代码,只关注接口形状;不要按实现成本评估。

该技能为提示词/流程型技能,具体工具依赖 Task 等子代理能力;收费、平台支持与安装方式暂未提供。