审计架构

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

必须使用工具

运行每个 Glob、Grep 和 Read this 提示列表。不要用训练数据来推理而不是扫描。按照编写的方式运行每个 Grep 模式;不要将它们折叠成一个大型正则表达式。运行每个部分要求的读取验证。 “构建心智模型”/“映射架构”意味着手头有工具输出,而不是来自记忆。

要排除的文件

跳过:*Tests.swift、*Previews.swift、*/Pods/*、*/Carthage/*、*/.build/*、*/DerivedData/*、*/scratch/*、*/docs/*、*/.claude/*、*/.claude-plugin/*

输出

编写简短的架构边界图(8-12 行),总结: 使用的架构模式(或混合/无) 视图计数与模型/视图模型计数(比例表示分离) 逻辑位置(视图、模型或混合) 依赖注入策略

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@CharlesWiltgen · MIT
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 3 步:了解架构策略

阅读 3-5 个关键文件(主视图、模型/视图模型、服务)以了解:是否存在一致的架构模式? (普通 SwiftUI、MVVM、TCA、协调员)业务逻辑位于哪里? (视图、模型、服务)如何注入依赖项? (环境、init、单例)代码是否可以在没有 UI 的情况下进行测试? (不导入SwiftUI可以测试逻辑吗)

02
第 2 阶段:检测已知的反模式

运行所有 5 个现有检测类别。对于每个 grep 匹配,在报告之前使用 Read 来验证周围的上下文 - grep 模式具有很高的召回率,但需要上下文验证。

03
第三阶段:架构完整性推理

使用第一阶段的架构边界图和您的领域知识,检查“缺失”的内容——而不仅仅是错误的内容。问题 · 它检测什么 · 为什么它很重要 视图主体中是否存在没有相应单元测试的业务逻辑? · 无法测试的逻辑 · 视图中的逻辑只能通过 UI 测试进行测试(慢 100 倍)或根本不进行测试 是否有超过 100 行正文的视图需要分解? · 整体视图 · 大视图难以理解,无法单独预览,并且难以重构

04
第四阶段:交叉参考结果

这些组合的碰撞严重性: 查找 A · + 查找 B · = 复合 · 严重性 视图正文中的逻辑 · 该逻辑没有单元测试 · 未经测试的业务逻辑 · 严重 异步边界违规 · 在关键流程中(购买、身份验证) · 无法测试、对时间敏感的关键事务 · 严重 @State 复制父数据 · 父更新数据 · 真实来源错误 — UI 显示陈旧数据 · 严重

05
第五阶段:架构健康评分

评分:干净:模型中没有关键问题,> 80% 的模型逻辑,一致的架构模式,正文中包含业务逻辑的 <3 个视图,0 个非视图 SwiftUI 导入 TANGLED:没有关键问题,但视图和模型之间的逻辑分裂,或不一致的模式,或一些异步边界违规 MONOLITHIC:任何关键问题,或视图中 > 50% 的逻辑,或没有模型层,或普遍的异步边界违规

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。