SuperAPI AI 工具集

architecture-diagrams

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:将基础设施源文件或已声明的 DS_CATALOG_V1 数据模型转为可读架构图,用于评审、ADR 和设计讨论,并保留调用方选定的输出格式与源文件的权威边界。

主要能力:基础设施输入支持 Terraform、Bicep、ARM 模板、shell 脚本、Kubernetes 清单、Docker 或 Compose 文件;目录输入使用 data-catalog 技能中已声明的实体与关系,不从 SQL 或 ORM 文件推断数据模型。输出为 ASCII 框图或 Mermaid 图,二者均非默认,由调用方或上下文选择;未声明偏好时先询问。基础设施源渲染为 ASCII 框图或 Mermaid 流程图,目录源渲染为 ASCII 实体行或 Mermaid erDiagram。

使用方式:按发现、解析、关系映射、生成四步执行。独立使用时读取根状态文件 .copilot-tracking/architecture-diagrams/state.json,其中 userPreferences.diagramFormat 须为 ascii 或 mermaid,repoVisibility 可选;解析顺序为显式请求或调用方状态、根状态文件,若未知则询问一次并持久化。目录输入可执行 scripts/render_catalog_erd.py 或遵循 catalog-erd.md。

限制:图是源权威的视图,不是自身语义权威。不得将 SQL DDL、Prisma、SQLAlchemy 等 ORM 作为目录输入;不得为目录连接键渲染主键、外键或唯一性标记。遇到不支持的目录版本、未解析端点、未知基数、缺失或无效端点最小值、未知置信度值或格式错误的连接键声明时应停止并报告,不得猜测或部分渲染。基础设施边界不明确时先询问范围;无法确定输出偏好时停止生成。软件系统(容器、组件及周边人员与系统)应改用 c4-architecture 技能。

适用场景:云基础设施拓扑梳理、数据目录关系可视化、架构评审与设计文档配图。

其他:官方文本暂未提供。