SuperAPI AI 工具集

technical-visual-companion

设计与创作

查看项目

更新于 10-15 22:14

技能介绍

用途:将对话中已确认的技术事实与决策,生成恰好一个可离线运行的静态 HTML 可视化文件,用于呈现架构、系统等关系。它不发明缺失架构、不静默补全未确认设计,也不替代设计讨论。

主要能力:生成自包含、离线可用的语义化 HTML,使用可访问的内联 SVG 表达关系;遵循自适应视觉语言,无固定模板;保留事实模型中的名称、数量、版本、状态与排除项;不含 JavaScript、iframe、CDN、外部字体或网络依赖。

使用方式:生成前需完整阅读 references/diagram-selection.md、references/visual-language.md、references/html-contract.md。先建立内部事实模型,再据其自动选择一至三个互补图示。输出路径由用户指定,否则为 docs/visuals/<topic-slug>.html。随后运行校验:python scripts/validate_html.py --html <absolute-html-path> --required-term <term> --required-term <term>,并做桌面与 390px 移动端视觉检查。

适用场景:把已确认的技术设计整理为单一离线可视化交付物。

限制:需输出目录写权限、Python 3.11 或更新版本、可做桌面与 390px 视口检查的浏览器;无浏览器时不得声称完成,只能报告视觉验证待定。输入含未定选项、来源冲突或缺失关键事实时应停止。不得覆盖已有文件,不输出 PNG、PDF、幻灯片、Mermaid 或多份用户文件。