SuperAPI AI 工具集

domain-architect

通用与其它

查看项目

更新于 10-16 03:46

技能介绍

用途:在 Swift 代码库中发现业务领域。它不依据文件夹名称、架构文档或文件数量,而是从产品能力出发——追踪“用户可以做什么”,并把每项能力映射为贯穿架构的垂直切片,最终产出一份领域地图;领域地图确定后,文件夹结构、SPM targets、约束规范和迁移计划才可机械推导。

主要能力:识别业务领域(如日程安排、收款、浏览可选项)、Provider(外部 SDK 桥接)、横切关注点(Infra、Utils、DesignSystem),并列出需与团队讨论的模糊边界问题。领域判断标准:能否用一句话向非工程师描述;每个领域拥有垂直层 Types→Config→Repo→Service→Runtime→UI,其中 Types、Config、Service 是最低要求。领域之间通过父 reducer 的代理动作、共享 Types、共享 Config 接口通信,不导入彼此内部实现。

使用方式:按流程执行。一、从入口找用户能力:grep -r "@main" <project-root> --include=".swift" -l,阅读根 reducer 的 Scope/CombineReducers 与 tab 枚举;多应用产品需分别处理。二、找动词:grep -r "@DependencyClient" <project-root> --include=".swift" -l,记录闭包名与类型,按领域分组。三、找名词:find <project-root> -name "Package.swift" -not -path "/.build/",阅读 Types 目标源码。四、逐领域追踪垂直层,每层至少阅读一个文件,不凭名称猜测。五、识别 Provider:grep -r "import Stripe|import Firebase|import Sentry|import Amplitude" <project-root> --include="*.swift" -l。六、识别横切关注点。七、以问题形式标记模糊边界。输出格式含领域地图、Provider 表、横切表与问题列表。

适用场景:Swift 代码库的领域梳理、架构重构前置分析、多应用产品中同一领域的动词差异比对(患者端与诊所端)。

限制:仅针对 Swift 项目;技能约定以提问代替决策,不自行裁定模糊边界;超过 200 个文件建议使用子智能体,每领域一个并完整追踪垂直层;要求 100% 客户端与 reducer 发现率、每领域每层至少读一个文件、显式报告缺失层;不先读架构文档,成型后再比对分歧。定价、许可与具体运行环境暂未提供。