SuperAPI AI 工具集

architecture-review

设计与创作

查看项目

更新于 10-16 02:35

技能介绍

用途:当用户需要架构评审、设计健康检查、架构风险的资深视角判断,或评估耦合与内聚时使用。对系统设计做批判性评估——边界、职责、耦合、数据流、失败模式、可演进性、信息隐藏,只读运行,产出书面评估和按优先级排列的建议,不改动源文件。

立场:对抗式而非平衡打分,聚焦错误、薄弱与风险点;不为了平衡而编造优点,任何维度或整体结论都可能为负。保持高信号,只提重要问题并深挖(根因、影响范围、证据),不堆砌浅层细节。术语与技术栈无关(如“上帝对象”在任何语言中都是上帝对象),格式、命名与惯用法不在范围内;但探针会适配技术栈,例如前端的设计系统/主题、UI/UX 与组件 API 一致性属于架构问题。

主要能力:识别所用架构风格并评估是否契合系统实际约束;精确命名模式(正确应用、误用或明显缺失);追踪服务与模块边界上的数据流和事务/一致性边界;定位弹性与扩展性上限(缺少熔断、无界队列、有状态服务);绘制信任边界与身份/密钥流转,标记认证、授权或密钥处理缺失或薄弱之处;评估模块深度、耦合方向、内聚与信息隐藏纪律;呈现真实的质量属性权衡;每个发现都以代码证据为依据,并在仓库提供时引用实测证据(打包报告、依赖图、覆盖率、性能剖析),而非仅靠阅读推断;愿意给出整体负面的结论。

流程:阶段一用 Agent 工具(subagent_type=Explore)构建系统地图,检测技术栈并列出仓库提供的构建/分析工具,记录导航摩擦,本阶段不打分。阶段二并行派生七个评审子代理,各负责一个视角:简洁性与可理解性、可维护性、可扩展性、安全性、性能与扩展性、模块化(深模块与耦合内聚)、可部署性(发布耦合、CI/构建矩阵耦合、运维影响范围)。每个评审按维度规约、知识库域与栈相关探针进行,并尽量运行工具实测、引用输出;无法测量时说明为估计。阶段三综合:去重、提炼跨视角主题(多视角汇聚处信号最强)、按影响排序,给出明确总体结论。阶段四交付:报告写入 ./docs/architecture-reviews/<descriptive-name>.md(必要时创建目录),遵循报告模板。

限制:不修改源码;不评判格式、命名与惯用法;未提供工具时结论基于代码推断并需注明;具体评分、严重级别标签与实现细节不在输出范围内。安装命令与版本信息暂未提供。