用途:visualize 用于在内容需要图示或可视化时,自动识别内容形态并渲染为合适的可视化形式,遵循 ai-workspace/rules/visualizations.md 中的 active-selection 规则。
用法: /visualize 表示可视化最近讨论的概念; /visualize <topic or file> 可视化指定内容; /visualize --format mermaid <topic> 强制指定格式。
主要能力(内容形态判定表):节点+边图(架构、依赖、组件间流转)用 Mermaid graph 或 flowchart;时序/交互(请求流、API 调用、多步协议)用 Mermaid sequenceDiagram;状态迁移(模式、生命周期、状态变化)用 Mermaid stateDiagram-v2;比较(3 项以上,如选项、权衡、功能矩阵)用 Markdown 表格;层级/树(文件结构、组织架构、简单嵌套)用 ASCII 图;对照(2 项,如前后、好坏、做/不做)用内联成对呈现;实体关系(数据模型、schema)用 Mermaid erDiagram。
渲染面判断:提交到 .md 文件中的 Mermaid 可在 iOS、web、GitHub、VS Code 渲染;在终端分块中 Mermaid 只是纯文本,应改用 ASCII。渲染面未知时默认用 ASCII。
渲染方式:ASCII、表格、内联成对直接输出在回复中;Mermaid 以围栏 mermaid 代码块输出。如需高分辨率 PNG,可运行:node --import tsx "${SKILL_DIR}/scripts/render-mermaid.ts" --input <mermaid-file> --output <png-path> --width 2400 --height 1800。若用户传入 --format,则无论自动检测结果如何都使用该格式。最后展示可视化结果,若生成了 Mermaid PNG 则显示其路径。
失败情况:内容形态不明确时询问“这更像 [X] 还是 [Y]?”;Mermaid 语法错误时显示错误并提供修复;mmdc 不可用时退回围栏 Mermaid 代码块(可在 GitHub/web 渲染)。
跨工具说明:Codex / Cursor 可直接运行 scripts/render-mermaid.ts 生成 PNG;内容形态检测属于智能体推理,而非脚本逻辑。
限制:资料未提供收费、平台支持范围等更多信息;实际可用性取决于渲染环境(终端宜用 ASCII)。