SuperAPI AI 工具集

architecture-diagram-react

前端与建站

查看项目

更新于 10-16 14:37

技能介绍

用途:当用户希望把架构图直接内嵌进 React/Vite 渲染的页面(如博客、文档)而非输出独立 HTML 文件时使用。它是 architecture-diagram 技能的嵌入版,只产出精简的图本体。

主要能力:输出一个 ```arch-diagram 围栏代码块,正文以 <svg> 开头,可带元数据注释 <!-- fig: ... | title: ... | label: ... -->,并支持 <lucide-icon> 占位符,由消费端运行时展开为真实图标。设计系统规则(语义色、字体、光晕、标签摆放、间距)沿用父技能。

必要用法:围栏标签必须为 arch-diagram;元数据注释为首行;正文须以 <svg> 开头,否则被当作普通代码。每个可能有重叠的 <text> 需自带 paint-order="stroke fill"、stroke="rgba(2,6,23,0.65)"、stroke-width="3" 光晕属性。浮层标签需在文本前紧邻绘制一个芯片矩形作为背景,且只能有一个,避免双边框。图标仅可使用受支持名称(如 database、server、monitor、cloud、shield、zap、user、git-branch 等共 32 个),未知名称会被静默移除。图标位于框左侧时须按公式预留文本空间,不可让文本居中覆盖图标。审计可运行:sed -n '/^<svg/,/</svg>/p' diagram-body.txt > /tmp/diagram.svg,再执行 python3 ${CLAUDE_PLUGIN_ROOT}/skills/architecture-diagram/resources/audit-labels.py /tmp/diagram.svg。

适用场景:内嵌在 React 页面中的架构图;由父技能生成图后要求“把它放到站点上”的后续步骤。若需要可分享的独立文件(Slack、PDF、幻灯片),应改用父技能。

限制:不得输出完整 <html> 文档;不得包含 <script>、<link>、<defs> 外的 <style>(会被清理);不得依赖外部 CSS,样式须为 SVG 属性或内联;不得使用 <foreignObject> 与 <script>;不得重复绘制背景网格;不得发明不受支持的图标名称。支持 <defs>、<pattern>、<marker>、渐变、<clipPath>、<mask>。缩放仅为阅读辅助,设计应以行内视图为先。