用途
该技能的主要用途是在聊天界面中通过自然语言指令生成图表,无需使用命令行工具。用户描述想要展示的内容,代理会根据 SKILL.md 和 references 文件中的指南,选择合适的图表类型、确认内容,并生成一个自包含的 HTML 文件。该文件内联 SVG 和 CSS,可直接用浏览器通过 file:// 打开,无需构建步骤或服务器。代理会先与用户确认再绘制,符合 SKILL.md 中“Confirm before drawing”的要求。
主要能力
- 图表类型选择:提供 39 种图表类型,分为结构系统、流程时间、数据、定量等类别。用户需描述“正在展示什么”,代理据此选择类型,例如架构图、流程图、序列图、ER 图、象限图、雷达图等。
- 语义模式:在行为比形状更重要时,可优先选择语义模式(如 fan-in 队列、瓶颈、策略追踪等),再映射到视觉类型。
- 输出调整:支持四个可调参数:format(html、svg、png、html+png)、size(doc-inline、doc-wide、slide-16x9、slide-4x3、social-og、social-square、print-a4-landscape、print-letter-landscape、fit)、detail(faithful、balanced、simplified)、audience(engineer、mixed、executive)。
- 无障碍与自包含:输出 SVG 具备无障碍属性(role、aria-labelledby、title、desc),文件不依赖外部资源(除 Google Fonts 外),无远程脚本或可执行属性。
- 动效可选:默认关闭,可显式请求 reveal、step、loop 模式,并遵循 prefers-reduced-motion。
- 模板:提供三个模板文件(template.html、template-full.html、template-motion.html),可通过 shell 复制后用聊天填充。
使用方式
用户直接在聊天中输入自然语言指令,例如:“Make me an architecture diagram of my app: frontend, backend, database, Redis cache.” 代理会选择合适的图表类型,加载对应的 references/type-*.md 文件,与用户确认后生成 HTML 文件。用户可通过类似“Same diagram at slide-16x9, simplified, executive audience.”的指令调整输出参数。使用模板时,先用 shell 复制模板文件,然后在聊天中要求填充内容。
适用场景
适用于需要快速创建架构图、流程图、序列图、数据模型、象限图、图表等可视化内容的场景,尤其适合在聊天环境中协作绘制,无需安装额外工具或编写代码。输出适用于文档、幻灯片、社交媒体预览、打印材料等。
限制
- 不支持通过 shell 命令直接生成图表,所有图表选择、内容选择和 SVG 编写均由代理完成。
- 动效默认关闭,需显式请求;动效文件必须包含完整的静态首帧和确定性时序。
- 若内容超出复杂度预算,技能会建议拆分为概览和详情,而非强行容纳。
- 输出文件需通过 self_check.py 检查(python3 <skill-dir>/scripts/self_check.py file.html)。
- 具体安装步骤、平台兼容性、费用等信息暂未提供。