Agent Skills: Maitreya (弥勒) - 架构可视化专家

架构可视化专家 (Maitreya) - 专注于创建高颜值、深层次、易于理解的架构流程图。支持 Mermaid 增强样式与高级 SVG 视觉方案。

UncategorizedID: aibangjuxin/knowledge/maitreya

Install this agent skill to your local

pnpm dlx add-skill https://github.com/aibangjuxin/knowledge/tree/HEAD/skills/maitreya

Skill Files

Browse the full folder contents for maitreya.

Download Skill

Loading file tree…

skills/maitreya/SKILL.md

Skill Metadata

Name
maitreya
Description
架构可视化专家 (Maitreya) - 专注于创建高颜值、深层次、易于理解的架构流程图。支持 Mermaid 增强样式与高级 SVG 视觉方案。

Maitreya (弥勒) - 架构可视化专家

概述

Maitreya Skill 旨在将复杂的系统架构转化为直观、精美且富有层次感的视觉流程图。它不仅关注逻辑的正确性,更关注“知识的能量密度”(浓缩铀)和视觉的极致体验。

核心原则

  1. 深度 (Depth):通过 Subgraph 和分层设计,明确系统的安全边界与逻辑层级。
  2. 清晰 (Clarity):节点命名简洁,关系描述精准,避免交叉混乱。
  3. 视觉美感 (Aesthetics):使用现代色调、渐变和阴影,通过颜色区分流量性质或安全区域。

视觉标准 (Maitreya Style)

1. 架构分层建议 (Zones)

| 区域 | 描述 | 推荐颜色 (Maitreya Palette) | | :--- | :--- | :--- | | Zone 1: Public | 外部客户端、Internet、未受信任区 | #2D2D2D (暗色) / #D63031 (警示红) | | Zone 2: Gateway | 入口控制、TLS 终止、WAF、认证 | #6C5CE7 (深紫) / #4A90D9 (云蓝) | | Zone 3: Mesh/Internal | 内部微服务、mTLS、Sidecar | #00B894 (薄荷绿) / #00CEC9 (青绿) | | Zone 4: App/Data | 业务逻辑容器、数据库、明文区 | #FDCB6E (暖黄) / #E17055 (砖红) |

2. Mermaid 高级样式模板 (ClassDefs)

使用以下 classDef 注入高级视觉效果:

graph TD
    %% 定义全局样式
    classDef default fill:#f9f9f9,stroke:#333,stroke-width:2px,color:#333,font-family:Inter;
    classDef zone1 fill:#636e72,stroke:#2d3436,color:#fff,stroke-width:2px,rx:10,ry:10;
    classDef zone2 fill:#6c5ce7,stroke:#5341d6,color:#fff,stroke-width:2px,rx:10,ry:10;
    classDef zone3 fill:#00b894,stroke:#009a7d,color:#fff,stroke-width:2px,rx:10,ry:10;
    classDef zone4 fill:#fdcb6e,stroke:#d4a84e,color:#333,stroke-width:2px,rx:10,ry:10;
    classDef highlight fill:#e17055,stroke:#c0553e,color:#fff,stroke-dasharray: 5 5;

    Node1[外部客户端]:::zone1
    Node2[API Gateway]:::zone2
    Node3[Microservice Sidecar]:::zone3
    Node4[Business App]:::zone4

    Node1 --> Node2
    Node2 --> Node3
    Node3 --> Node4

SVG 高级定制指南

当 Mermaid 的表达力遇到瓶颈时,可以直接在 Markdown 中嵌入 SVG 代码以获得极致控制(阴影、渐变、手绘感)。

1. 玻璃拟态 (Glassmorphism) SVG 模板

<svg width="200" height="100" xmlns="http://www.w3.org/2000/svg">
  <defs>
    <linearGradient id="glass" x1="0%" y1="0%" x2="100%" y2="100%">
      <stop offset="0%" style="stop-color:rgba(255,255,255,0.2)" />
      <stop offset="100%" style="stop-color:rgba(255,255,255,0.05)" />
    </linearGradient>
    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
      <feGaussianBlur in="SourceAlpha" stdDeviation="5" />
      <feOffset dx="2" dy="5" result="offsetblur" />
      <feComponentTransfer>
        <feFuncA type="linear" slope="0.3" />
      </feComponentTransfer>
      <feMerge>
        <feMergeNode />
        <feMergeNode in="SourceGraphic" />
      </feMerge>
    </filter>
  </defs>
  <rect x="10" y="10" width="180" height="80" rx="15" fill="url(#glass)" stroke="rgba(255,255,255,0.3)" stroke-width="1" filter="url(#shadow)" />
  <text x="100" y="55" text-anchor="middle" fill="#333" font-family="Arial" font-size="14">Maitreya UI</text>
</svg>

架构绘图工作流

  1. 识别层次:先确定请求流经的物理或逻辑层(North-South, East-West)。
  2. 定义边界:使用 subgraph 明确隔离域(GCP Region, Cluster, Namespace, Workspace)。
  3. 标注加密:使用带标签的箭头(-->|"TLS 1.3"|)明确标注加解密点。
  4. 注入样式:应用 classDef 统一视觉语言。
  5. 浓缩提炼:在图表下方附带“浓缩铀”级别的技术总结(例如连接池、重试机制的关键参数)。

示例库

场景:多级代理流量链

graph LR
    User((User)) -->|HTTPS| GLB{Cloud LB}
    GLB -->|mTLS| GW[Gloo Gateway]
    GW -->|mTLS| Sidecar((Sidecar))
    Sidecar -->|Plaintext| App(Business Container)

    classDef zone2 fill:#4a90d9,stroke:#1e3c72,color:#fff
    classDef zone3 fill:#27ae60,stroke:#1d8348,color:#fff
    class GGW,GW zone2
    class Sidecar,App zone3

[!TIP] 关于 SVG 生成: 如果需要更细致的图标或渐变,可以通过 generate_image 工具生成底图,或编写原生 SVG 代码直接输出。