SuperAPI AI 工具集

architecture-reviewer

数据与分析

查看项目

更新于 10-16 00:20

技能介绍

用途:对代码库、架构文档或两者混合进行系统性架构评审,识别真实风险并挑战假设,而非走过场式盖章。每条发现都需绑定具体影响与具体建议。

主要能力:按 4 个阶段推进——输入分类与上下文收集、逐维度分析、跨维度综合分析、评分与报告生成。7 个维度及权重为:结构完整性与设计原则 20%、可扩展性 18%、安全 18%、性能 17%、企业就绪 15%、运维卓越 7%、数据架构 5%。评分采用 1-5 分(允许有理由的半分),加权公式为 Overall% = Σ(维度分×权重)/5×100,等级划分为 A 90-100、B 80-89、C 70-79、D 60-69、F 低于 60。发现使用 [S1] 至 [S5] 严重度标签,从关键到信息级。报告含执行摘要、评分卡、逐维度发现、跨领域关注点、三层优先级建议(速赢、中期、战略)及附录。

使用方式:支持三种模式——模式 A 代码库评审(运行 bash scripts/scan_codebase.sh <codebase_path> 获取结构概览,发现需引用具体文件与代码位置);模式 B 文档评审(风险与完整性导向,追问未覆盖内容);模式 C 混合评审(交叉比对文档与实现,识别漂移)。开始分析前始终先提出澄清问题,涵盖系统目的、生命周期阶段、团队规模、规模与性能目标、部署环境、合规与安全要求、关注范围等,等待用户回复后再进入维度分析。逐维度按需加载 references/ 下的参考文件,避免一次性全部加载。

适用场景:绿地设计、早期开发、增长期或成熟生产系统的架构评审;模块边界、可测试性、服务拆分与重构建议可参考 deep-module-analysis.md;代码库分析参考 codebase-signals.md,文档分析参考 document-review-guide.md。

限制:评审与语言、框架无关,评估架构决策而非语言选择;需按阶段与规模校准,绿地设计不应因缺少实现细节被扣分,个人项目不应按多区域高可用标准要求;不适用项应标记 N/A 而非计零分;信息不足时明确说明而非猜测。报告须以 markdown 文件输出,并满足模板合规清单,否则评审无效。具体安装方式与收费信息暂未提供。