SuperAPI AI 工具集

design-an-interface

编程与开发

查看项目

更新于 10-18 16:13

技能介绍

用途:为某个模块设计接口(API)时,借助并行子代理生成多个差异极大的设计方案,再逐项对比,最后综合优点形成更合适的接口。

主要能力:

  • 需求收集:先明确模块要解决的问题、调用方、关键操作、约束条件,以及哪些内容应隐藏、哪些应暴露。
  • 并行生成设计:同时启动 3 个以上子代理,给每个子代理分配不同的约束,例如最少方法数、最大灵活性、针对最常见场景优化、借鉴特定范式或库,从而产出差异明显的接口。
  • 每个方案输出接口签名、调用示例、内部隐藏的内容以及取舍。
  • 依次展示各方案,再按接口简洁性、通用与专用程度、实现效率、深度(小接口隐藏大复杂度)和易用、易误用程度进行比较,并用文字论述而非表格。
  • 综合阶段会询问哪个方案最贴合主要用例,以及是否要吸收其他方案的要素。

使用方式:先与用户确认模块需求,再用 Task 工具并行派发子代理,按给定模板让每个子代理产出接口签名、用法示例、隐藏内容与取舍,然后展示、比较并综合。

适用场景:设计 API、探索不同接口形态、在动手实现前比较多种模块抽象。

限制:该技能只关注接口形态,不进行实现,也不按实现工作量来评估;应避免子代理产出雷同方案,也不要跳过比较环节。