SuperAPI AI 工具集

swift-api-design

编程与开发

查看项目

更新于 11-10 10:36

技能介绍

用途

该技能面向 Swift API 表面的设计、重命名与审查工作,其判断依据是随技能打包的官方 API 设计指南。它强调从真实调用点出发评估 API 设计是否合理,适用于“API 形态”本身属于工作范围的场景,而不针对每一项 Swift 实现任务。

主要能力

  • 针对 API 设计给出推荐签名与有用的调用点示例。
  • 为所建议的变更提供相应的指南条款作为依据。
  • 支持对现有 API 进行审查。
  • 按决策类型引导查阅随附参考材料。

使用方式

根据当前决策查阅对应参考内容:

  • 涉及设计原则或竞争方案:查阅核心原则。
  • 涉及名称、参数标签、默认值或重载:查阅命名与签名。
  • 涉及弱领域类型、布尔参数或方法族:查阅 API 模式。
  • 审查现有 API:查阅审查清单。
  • 需要上游原文措辞或示例:查阅官方指南。
  • 需要打包版本信息:查看 assets/manifest.json。

适用场景

适合需要权衡或调整 Swift API 形态的任务,例如为 API 命名、设计签名与参数、评估多种设计方案、审查既有接口是否符合官方设计准则。

限制

资料未提供具体的安装命令、收费方式、价格、平台支持范围或效果数据,这些信息暂未提供。该技能不适用于与 API 形态无关的常规 Swift 实现任务。