SuperAPI AI 工具集

type-specimen

设计与创作

查看项目

更新于 10-15 21:53

技能介绍

用途:在真实产品文案下比较候选字体,而不是用“Hamburgefonstiv”这类样张判断。它构建一个自包含 HTML 页面,把入围字体族用产品实际发布的文案排布,使比较发生在候选字体执行真实任务时。页面为单文件,无构建步骤、无依赖,字体族在查看时从 Google Fonts CSS API 加载。

主要能力:页面渲染十个文本槽位,每个有固定形状并由 specimen check 校验:display、timer、headline、weights、prose、caps、rows、table、tableHead、alphabet。文案应取自产品而非凭空编造;ux-writing 拥有的字符串应逐字使用。两条关键规则:使用最长现实值而非平均值;alphabet 槽位必须覆盖产品发布的每种文字,scriptRange 可标记缺少该文字的字体族。候选字体族每行一个,格式为 name :: group :: note,名称须与 Google Fonts 目录完全一致,六到十个为工作范围。

使用方式:常用命令包括 scripts/specimen init -o spec.json --locale ru --context "..." 启动;scripts/specimen texts spec.json --from-file README.md 输入简报;scripts/specimen texts spec.json 查看待写槽位;scripts/specimen texts spec.json --set headline="..." 写入槽位;scripts/specimen check spec.json 仅校验;scripts/specimen build spec.json 构建并打开。构建产物与 specimen.json 默认放在 .design/specimen-<name>,可用 -o 指定其他位置,不应默认写入当前工作目录。构建后在页面中可就地编辑文本、设置真实背景与文字颜色、展开卡片查看正文、表格、字形覆盖与可变轴,复制链接可编码全部状态。

适用场景:为仪表盘、收据、营销页等界面选型,需要按阅读距离与文字覆盖范围评估字体时。

限制:样张是证据而非结论,不能判断哪个字体正确,也不应给字体打分排名;不得声称未检查的覆盖范围;failed to load 徽章通常表示名称与目录不匹配,应先检查拼写;对比度读数描述的是所设颜色对,需连同颜色一起引用。若项目已有字体,应说明并将其作为基线纳入样张,而非悄悄提议替换。测试命令:cd humane/skills/type-specimen && python3 -m pytest tests/ -q。