SuperAPI AI 工具集

solid-swift

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:在编写或重构 Swift 6/SwiftUI 代码时应用 SOLID 原则,控制文件职责与体积,规范协议分离、@Observable、actor 与功能模块化架构。

主要能力:覆盖 SRP、OCP、LSP、ISP、DIP 五大原则,并提供并发模式(actors、@MainActor、Sendable)、反模式目录,以及视图、视图模型、服务、协议、模型的代码模板。

使用方式:写新代码前必须先在代码库中检索可复用的协议、服务或逻辑,并检查共享位置 Core/Extensions/、Core/Utilities/、Core/Protocols/;若代码会被 2 个以上功能使用,应直接放入 Core/。架构上强制采用 Features/[Feature]/ 结构,禁止扁平的 Sources/。工作流要求并行启动 3 个 agent:explore-codebase 分析现有架构、research-expert 通过 Apple Docs MCP 与 Context7 核对文档、XcodeBuildMCP 在改动后做构建验证,随后运行 sniper。

关键规则:文件行数仅受钩子上限 FUSE_SOLID_MAX_LINES 约束,且一个文件只承担一个职责;ViewModel 使用 @MainActor @Observable;协议只能放在 Features/[Feature]/Protocols/ 或 Core/Protocols/;模型为 Sendable struct;所有公开 API 加 /// 文档;每个 View 必须有 #Preview。

适用场景:Swift 6/SwiftUI 项目的架构设计、代码审查与重构,尤其是需要拆分臃肿视图/视图模型、引入依赖注入与可测试协议、处理并发安全时。

限制:资料未提供安装命令、收费方式、平台支持范围与具体效果数据;文件行数上限由环境变量 FUSE_SOLID_MAX_LINES 决定,资料未给出默认值;若合法修复无法满足钩子上限,应上报而非绕过钩子。