用途:brandkit-build 是 ai-brand-kit 流程的第 3 步(共 4 步)。输入为 brandkit-interview 产出的品牌描述草稿,输出为一个可直接使用的 Brand Kit 文件夹。核心思路是“压缩而非删减”:保留每个数字、Hex 值、尺寸与禁用清单,删去论证、推导与重复内容,并把散文改写为表格。
产出结构:Brand/ 目录下含 CLAUDE.md(工作规则,在该目录内自动生效)、BRAND.md(约 250 行以内的短版规范,核心文件)、REFERENCE.md(访谈原始草稿,作参考)、README.md(说明文件位置及目录外使用的起始句)、brand-helmet.html(Google Fonts 链接与 :root 中全部令牌的 CSS 变量)、brand-props.json(设计编辑器中可切换的强调色)、wordmark.svg(字标)、mark.svg(方形图形标)、beispiel/(含全部构件的可运行参考)。建议把该目录放在长期位置并初始化为 Git 仓库。
BRAND.md 建议结构:一句话品牌与一行个性;令牌表(变量名、Hex、角色)及面积占比;字体排印(2–3 个角色与各格式字号阶梯);网格与间距(数值序列、页边距、圆角、边框、阴影);字标使用规则(何时用哪个文件、最小尺寸、留白、禁止项);构件与具体尺寸;各用途像素尺寸;文案(语言、称谓、正反例、禁用清单);硬性禁用清单;交付前 10 项是非检查表。要点是用百分比替代形容词、用具体尺寸替代原则,并详细写出禁用清单。
CLAUDE.md 机制:不写此文件则每次会话需手动提及该 Kit;写了之后在目录内工作时规则自动生效。它只规定如何处理其他文件:冲突时以哪个文件为准、只使用已定义令牌、参考示例位置、修改 Kit 本身需先协商。模板位于 assets/CLAUDE.md.template。目录外使用时需在 README 中提供起始句,例如:Lies zuerst <PFAD>\BRAND.md und halte dich exakt daran. Referenz-Artboards: <PFAD>\beispiel\。README 需明确说明 Kit 不会自动加载。
可执行部分:brand-helmet.html 含 Google Fonts 链接与 :root 中全部令牌的 CSS 变量,以及基础样式和 1–2 个辅助类(如 .lbl、.val),模板为 assets/brand-helmet.html.template;布局中只写 var(--...),改色只需改一行。brand-props.json 让强调色在设计编辑器中可切换;注意若提供功能性颜色(警告、错误),可能被误设为品牌强调色,建议只提供品牌色,或在 BRAND.md 中写明该切换是检查工具而非第二品牌强调色。wordmark.svg 与 mark.svg 应基于字标而非符号构建。注意:含 <text> 的 SVG 依赖显示设备上的字体,离开浏览器(打印或 Illustrator)会回退字体,README 中需说明字标离开浏览器前须转为路径。
beispiel/ 参考:至少构建两个可运行示例面(通常桌面与移动),展示全部构件的正确尺寸;示例数据须明确标注为示例,避免虚构数字流入真实页面。
限制与注意:草稿中未确定的内容应保持“未确定”并写明,不得编造看似合理的值。最后用刚写的检查表核对参考画板,并简要报告产出内容、位置、BRAND.md 长度及未决事项,后续用 Kit 构建参见 brandkit-publish。资料未提供具体安装命令、收费或平台信息。