SuperAPI AI 工具集

swift

通用与其它

查看项目

更新于 10-16 06:45

技能介绍

用途:该技能在创建和编辑 Swift 文件(*.swift)时使用,提供一套 Swift 代码风格指南,帮助保持代码一致性与可读性。

主要能力:涵盖命名、风格、函数、运算符、模式、SwiftUI、测试和性能等方面的约定。命名上要求类型与协议用 UpperCamelCase,其余用 lowerCamelCase;布尔值以 is/has 开头;缩写除位于 lowerCamelCase 名称开头外保持全大写;事件处理函数用过去式(如 didTap);避免 Objective-C 风格缩写前缀。风格上优先类型推断、省略不必要的 self、为元组字段命名、优先复用已有标识符解包可选值、单表达式返回值优先用 if 表达式、优先 for 循环而非 forEach。函数与模式上避免 unowned 捕获、优先在 init 中初始化属性、避免在 init 中做耗时工作、省略冗余的成员逐一初始化器、用 guard 做前置校验、避免全局函数、优先不可变值、类默认 final、枚举 switch 优先穷举所有 case、用 os_log 或 swift-log 而非 print、避免 #file 与生产代码中的 #filePath、优先 some 不透明泛型参数、避免 @unchecked Sendable。SwiftUI 内部视图优先使用合成的成员逐一初始化器,@State 等动态属性保持 private。测试方面,Swift Testing 用例名用原始标识符写成句子且不加 test 前缀,测试套件用 UpperCamelCase,省略显示名,避免重复期望的消息字符串,避免 guard 与强制解包,测试用例为 internal、辅助成员为 private。性能上优先 count(where:)、isEmpty、flatMap、contains、first(where:)、min(),并在链式归约为单一结果时使用 lazy.map。Apple 框架方面,NSRange 等使用构造器而非 Make() 函数,优先 CIFilter 的类型化工厂方法而非字符串初始化器与 KVO setValue。

使用方式与限制:资料未提供具体安装命令、配置步骤或调用方式,暂未提供。该技能为风格约定集合,不涉及收费、价格或平台信息。