Hallmark study 构建流程：从 DNA 诊断到锁定构建的完整指南

Hallmark study 构建流程：从 DNA 诊断到锁定构建的完整指南

【免费下载链接】hallmarkAnti-AI-slop design skill for Claude Code, Cursor, and Codex.项目地址: https://gitcode.com/GitHub_Trending/hal/hallmark

Hallmark 是一个反 AI 模板味（anti-AI-slop）的设计技能，而 study 是它最有特色的动词：给它一张你欣赏的页面截图或一个网址，它会做一份“设计 DNA 诊断报告”——不抄像素，只提取结构、字体搭配、色彩锚点与节奏。本文带你走完从 study 诊断到锁定构建、并挂起多样性的完整流程，新手也能照着做。

为什么用 study：提取设计 DNA，而不是像素级复制

AI 生成的网页最大的问题不是难看，而是千篇一律：居中标题 + 三张卡片 + CTA + 页脚，换个配色就是一份新模板。Hallmark 对此的态度是“结构性多样”——同一个技能为两个不同需求产出的页面，应该像两个不同的网站，而不是同一模板的换色版。

study 的心智模型很简单：一位喜欢某个参考站点的设计师，绝不会把它复印下来。他会看足够久，说出"啊——这是一个 Marquee Hero 配单栏正文、斜体衬线标题配等宽字体标签、锚在一个低饱和度森林绿上"，然后用同一副骨架做一个完全不同的东西。这句话，就是 study 的产出。

它的核心承诺写在协议文件 study.md 里：

• ✅ 提取DNA：宏观结构（macrostructure）、组件原型（archetype）、字体搭配角色、色彩锚点、节奏
• ❌ 永不复制像素、永不输出原站的外壳
• ❌ 拒绝模板市场的付费模板截图/网址
• ⏸️ 先给诊断报告，等用户确认后才写代码

study 诊断报告：五步协议与 10 个结构化字段

study 支持两种输入模式，自动检测：以http://或https://开头走URL 模式（能读到精确的字体名和 OKLCH 色值，但读不出节奏）；否则走图片模式（看截图，节奏能读，但字体只报“角色”不报具体名字——因为视觉识别字体一半时候会错）。

无论哪种模式，提取都按固定的五步协议顺序进行（详见 study.md 的五步协议）：

1. Surface（表面）：纸张明度带（深/中/浅）、色调倾向、强调色色相与占比（≤5% 算“小声”，>15% 算“刷屏”）
2. Type（字体）：只认角色——展示角色、正文角色、标签角色，再给出 1–2 个可落地的候选字体
3. Structure（结构）：把页面匹配到 21 种命名宏观结构之一（索引见 macrostructures.md），并为 Hero、导航、页脚分别挑原型与“旋钮值”（原型目录在 component-cookbook.md）
4. Motion（动效）：识别揭示模式与缓动语气，顺带标记transition-all、hover 放大这类不该带过来的反模式
5. Rhythm（节奏）：密度、留白纪律、不对称方向——这是 URL 模式的已知盲区，会被明确标注

五步之后填一份结构化字段表，再渲染成一页纸的诊断报告（约 10 句话），包含：宏观结构名、原型与旋钮、字体搭配、表面与强调色、密度判断，以及一张“源页面有、但你不要带过来”的反模式清单。仓库里就有一份可直接阅读的完整实例：diagnosis.md，三个面向人类读者的演练案例在 study-examples.md。

诊断报告的最后固定有两个钩子：

• 确认问题：“用这套 DNA 构建，还是先换掉某一个轴？”
• 输出钩子：“或者说lock the DNA，把这套 DNA 导成可移植的 design.md”

两个都是选做——不点头，study 就停在诊断，一行代码也不写。

确认之后：构建、挂起多样性，或锁定 design.md

用户确认后，流程分三条岔路（协议见 SKILL.md 的 hallmark study 章节）：

锁定构建：studied-DNA 成为系统，多样性被挂起

一旦你说“build it”，构建流程的主题路由会命中一个特殊条件：studied-DNA。此时：

• 跳过主题目录（catalog）与自定义（custom）的分发——诊断报告里的纸张 OKLCH、强调色、字体角色、宏观结构、导航/页脚原型直接成为本次构建的锁定系统
• 多样化规则被挂起：平时 Hallmark 强制“两次构建必须在纸张明度/展示风格/强调色三个轴上至少差一个”，而这次你在跟随外部 DNA，不是在轮转目录，所以不轮换
• 产出的 CSS 第一行会打上theme: studied-DNA (source: ...)的印章，并内联真实的色值与字体候选；项目记忆.hallmark/log.json里也记为theme: studied-DNA，下一次运行时不会拿它当“上一页”来反着轮换
• 如果你之后改口——“用 Linen 主题代替”——就切回正常分发，多样化恢复运转

这个studied: yes印章还会影响后来的audit（审计）：对用户显式选择的 DNA，"Specimen 惯性"这类检查会更宽松；但“页面有没有真的用上提取的 DNA、还是偷偷漂回默认模板”这一条，查得更严。完整的一次演练（输入 → 诊断 → 构建 → 印章）可以看 study 测试笔记 和 verbs 测试说明。

挂起多样性 ≠ 放弃一致性：用 lock the DNA 把 DNA 固化成文件

“挂起多样性”只作用于那一次构建；如果你希望这套 DNA 成为整个项目的长期系统，就触发design.md输出。要点：

• 触发短语是硬门槛：只有你说 “lock the DNA”“give me a design.md”“make this portable” 之一才会写文件，只确认诊断不算
• 输出有比诊断更严的许可层：图片模式默认放行（截图归你）；URL 模式必须先回答一个问题——这个网址是 (a) 你自己的站、(b) 自己品牌的公开参考，还是 (c) 别人的站？(c) 会被拒绝
• 文件里带## Provenance（来源与日期）和## Notes（不要带过去的反模式）区块
• 写文件之后，规则反转：后续所有 Hallmark 运行会先读 design.md，目标从“每页都不同”变成“每页都一致”——多样性正式让位于系统一致性

上手清单：新手照这 4 步走

1. 准备参考：一张截图（推荐，节奏可读）或一个公开页面 URL；一次只给一个来源——五个截图混合提取只会得到“模板汤”
2. 触发诊断：对 AI 助手说hallmark study <截图或URL>，等待一页纸的诊断报告
3. 做决定：改一个轴（如只换主题）、说build it进入锁定构建、或说lock the DNA导出可移植文件
4. 验收：检查产物 CSS 首行的studied: yes印章与 tokens.css 风格的令牌引用，确认内容全是你自己的、参考站的一个像素都没被抄走

记住 study 的一句话边界：骨架来自截图，文字与项目来自你——这既是它的纪律，也是它和你想要的“像素级克隆工具”之间最大的区别。

【免费下载链接】hallmarkAnti-AI-slop design skill for Claude Code, Cursor, and Codex.项目地址: https://gitcode.com/GitHub_Trending/hal/hallmark