SuperAPI AI 工具集

discover-architecture

通用与其它

查看项目

更新于 10-15 20:29

技能介绍

用途:通过直接检视源代码来发现代码库的架构风格。它强调架构是结构与关系,需阅读代码而非扫描 Dockerfile 或匹配目录名。

主要能力:提供 12 种经典架构风格分类(微内核、分层、模块化单体、事件驱动、管道、微服务、基于服务、六边形、领域驱动设计、多智能体、空间基、CQRS),并对每种列出特征。分类流程包括:清点代码库、检查代码结构、带证据分类、确定范围与用途类型、识别质量属性、推断领域。输出 Markdown 报告,含架构风格、证据摘要、检测到的质量属性、领域与生产上下文;也可按 catalog-schema.yaml 输出 YAML 条目。报告模板位于 references/report.template.j2,保存路径为 docs/architecture-reports/<project-name>-<YYYY-MM-DD>.md。

使用方式:先并行运行根目录与关键子目录的 ls,阅读 README、ARCHITECTURE.md 等文档与包元数据;再阅读入口文件、依赖注入配置、代表领域文件和通信代码;最后分类并给出置信度与证据。

适用场景:分析生产或参考项目、平台或应用、单体仓库;对库/框架按其本身归类。

限制:源码分析无法看到性能、安全、可测试性等质量属性;小于 10 个源文件的仓库可能分类无意义;代码过于扁平、过小或非常规时可能判定为 Indeterminate。文档与代码冲突时以代码为准。