用途:当用户要制作兼具杂志/数据新闻、技术文档、计算笔记本三种美学风格的静态 HTML 页面,并嵌入程序化图表、手写内联 SVG 或白板风格图示时,用于推荐技术栈。触发场景如“创建静态页”“构建仪表盘”“设计复盘报告”“搭建技术文档站”等。
主要能力:按层给出选型与备选。作者层推荐 Quarto(备选 Quartz、Jupyter Book 2/MyST);视觉系统推荐 Open Props + 原生现代 CSS(备选 Pico.css),以语义化 token 替代 Tailwind 工具类;字体推荐 Inter + Crimson Pro + Fira Code;程序化图表推荐 Observable Plot(备选 Vega-Lite、ECharts);白板用 Excalidraw + excalidraw_export CLI(tldraw 有商用授权费用);手绘风格可用 rough.js;内联 SVG 用 CSS 变量模式与 symbol/use 复用图标;滚动叙事用 Closeread 或 Scrollama。
必要用法:提供决策流程,按需求选择框架、图表库、图示库三件套;默认推荐 Quarto + Open Props + Observable Plot + Excalidraw。给出从 Tailwind CDN 迁移到 Quarto + Open Props 的分阶段方案(试点、美学升级、图表、滚动叙事、推广)。
限制与说明:Quarto 默认主题并非杂志级,需投入约 1-2 周定制 SCSS;Observable Framework 存在公司裁员风险;Open Props 需学习 token 命名。资料明确 Distill 已停止、Idyll 休眠、tldraw 有商业授权条款,不建议推荐。文档强调“XHTML”在现代应理解为语义化 HTML5。本技能为自演进技能,遇到可复现问题应即时更新。