用途:用一个 design-system.md 文件决定所有图表的视觉风格。文件包含供脚本读取的 design-tokens JSON 块,以及供绘图模型读取的散文(词汇表、原则、do/don't)。illustration-draw、mermaid-draw、diagram-animate、diagram-review 的 lint 都以相同方式加载它,因此指向另一个文件即可在下次渲染时整体换肤。
主要能力:解析顺序为 --design-system PATH-or-NAME → $DIAGRAM_DESIGN_SYSTEM → ./design-system.md → 内置 Studio 外观(assets/design-system.md)。名称(如 coral)会在 ./themes/、$DIAGRAM_THEMES 各目录、~/.config/diagram-skills/themes/、随附 assets/themes/ 中查找 <name>.md;design_tokens.py --list-themes 可查看解析结果。主题文件只列出改动项,其余继承(extends 接受名称或路径)。输出在生成时固化令牌,换主题需重新生成,不能改 SVG。
随附主题:studio、studio-ink、paper-line、coral、coral-blocks、midnight、wave、wave-light。所有令牌见 references/token-schema.md。
使用方式:从最接近的随附文件开始,复制 assets/design-system.md 或某主题为项目中的 design-system.md。若品牌只给几个值,写只含这些令牌的部分文件。从 moodboard 出发时先测量:python3 "${CLAUDE_SKILL_DIR}/scripts/derive_palette.py" path/to/moodboard,再人工判断圆角、边框、图标风格、字体与密度。检查:python3 "${CLAUDE_SKILL_DIR}/scripts/design_tokens.py" --check design-system.md,硬错误会以退出码 1 报出失败组合与比值。验证换肤:用默认与新文件各渲染一个样例并对比 PNG。
限制:不用于绘制图表(用 illustration-draw 或 mermaid-draw),不用于 Web 应用、Tailwind/shadcn 主题或 UI 套件,也不用于审查单张图(用 diagram-review)。检查器强制:文字在其所在表面(画布、卡片、磁贴、组、注释、胶囊、徽章、强调色)对比度 4.5:1,连接线 3:1,强调色只作墨迹底色而非文字或线条,neumorph 模糊 ≤ 5 px。未知键会报错。字体为系统栈,需以通用族结尾,不抓取 Web 字体。GitHub 渲染的 Mermaid 无法加载该文件,可用 mermaid-draw 的 render_themed.py --config 打印等价配置。本仓库不绘制的类型交给 diagram-design,可用 scripts/to_diagram_design.py --design-system <theme> [--write --marker .] 生成 profile 与项目标记。