技能介绍

架构图绘制的痛点

在技术方案汇报、评审或文档编写中，架构图几乎是标配。但手绘架构图常遇到这些问题：分层不规范，模块划分随意；调用关系不清，箭头指向混乱；输出格式单一，PPT 用图、文档用 Mermaid 代码、开发文档用 JSON，每份都要重新调整。更现实的是渲染质量——层标题被箭头穿过、标签压在卡片上、同层连线穿越中间模块，这些在手动绘图中难以避免。

技能如何工作

本技能将一段产品描述转化为标准化的 5 层架构，固定层级自上而下为：用户层 → 应用层 → 服务层 → 数据层 → 基础设施层。它从用户消息中解析 6 个参数，必填项包括 product_name、product_type、target_users、core_features，可选项为 tech_preference（影响组件命名）和 scale_level（影响模块深度）。

工作流程分 5 步：解析参数 → 推断架构模型 → 技术栈推荐 → 解析调用关系 → 生成交付物。架构模型从 references/component-library.md 读取对应产品类型的推荐组件，结合核心功能裁剪；技术选型根据技术偏好映射到阿里云、腾讯云、AWS 或开源栈；调用关系矩阵为相邻层间定义 call、data、realtime、batch 四种链路类型并分配语义化颜色。

最终产出 4 种格式：可视化架构图（主交付，通过 scripts/generate_diagram.py 从 JSON 规格确定性渲染）、Mermaid 代码、ASCII 图、结构化 JSON。脚本内置排版约束：标题保护罩覆盖整段标题文本，同层链接画在卡片下方，标签经过 bbox 碰撞检测后自动错开，确保无遮挡、无重叠。

适用边界与注意点

适用于方案汇报、技术评审、招标材料、产品白皮书等需要标准分层架构的场景。支持 SaaS、IoT 平台、数据平台、AI 平台、云原生/微服务、PaaS、电商/小程序、单体应用等类型；若类型不在支持列表，按最接近类型推断并在输出中注明假设。架构层级固定为 5 层，不适合事件驱动、管道式等非分层架构。可视化图为 HTML 格式，需在支持 HTML 的环境中展示。