Communitygithub.com

Tantless/mine-mail

反AI模板化设计技能,适用于全新页面、审计、重新设计以及从URL或截图提取设计DNA。当用户要求构建新应用或落地页、重新设计内容、显式调用Hallmark名称或使用审计/重新设计/研究动词时触发。

mine-mail 是什么?

Hallmark 是一套专为 AI 编码助手(如 Claude Code、Cursor 等)设计的设计技能,旨在让生成的 UI 看起来像是“做出来的”,而不是“生成出来的”。它编码了一套严格的反模板化规则——综合了 Anthropic 前端设计技能、Claude cookbook 中关于前端美学的共识以及 2026 年“触觉反叛”运动的理念——并拒绝让模型回退到大多数 LLM 训练数据中默认的平庸样式。其核心差异化在于强调**结构多样性**而非单纯的视觉多样性:两个不同需求生成的页面不应共享相同的英雄区→三个特性→CTA→页脚的节奏。该技能支持三种显式动词(audit、redesign、study)以及一个默认的设计流程,在全新项目或现有代码库中都能安全运作。它还内置了预发射自我批评、诚实内容、锁定设计令牌、禁止伪造浏览器/手机/IDE视觉框架、严格移动端响应式和无斜体标题等六大跨动词纪律,确保输出质量。此外,Hallmark 能智能区分组件级请求与页面级请求,对组件提供完整八大状态代码,并以设计令牌的形式保证系统一致性。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Tantless/mine-mail/tree/HEAD/.agents/skills/hallmark

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Hallmark

面向 AI 编码助手的设计技能。让它们生成的 UI 看起来是“做出来的”,而不是“生成出来的”。

Hallmark 是有主见的、精简的、且故意保持朴素。它编码了一套严格规则——这些规则来自反 AI 模板化设计领域的共识(Anthropic 的前端设计技能、关于前端美学的 Claude cookbook,以及 2026 年“触觉反叛”运动)——并拒绝让模型退回到每个 LLM 在训练数据中学到的默认样式。

不同之处:Hallmark 坚持的是结构多样性而不仅仅是视觉多样性。由 Hallmark 为两个不同需求生成的两个页面,不应共享相同的“英雄区 → 三个特性 → CTA → 页脚”节奏。它们应该让人觉得是不同的网站,而不是同一模板的不同配色版本。参见 references/structure.md。

由 Together AI 提供支持。


如何使用此技能

Hallmark 有一个默认行为和三个显式动词。

触发方式功能
(默认)用户要求你设计或构建新内容。请遵循下面的 设计流程。
hallmark audit <目标>读取目标,对照反模式列表评分,生成一个按优先级排序的问题清单。不要编辑。
hallmark redesign <目标> [--mood <名称>]获取目标的内容和意图,然后在现有实现边界内重新设计视觉结构——除非用户明确确认可以完全重建。新的章节节奏、新的标题位置、新的组件风格。保留现有的路由、组件归属、文案意图、品牌和信息架构;仅替换在请求范围内所需的视觉/交互层。
`hallmark study <截图URL>`

如果用户输入的内容不能明确映射到 audit、redesign 或 study,则视为默认行为。如果用户附加了图片或粘贴了 URL 而没有动词前缀,请询问:“我应该 study 这个(提取 DNA),还是将其视为全新构建的参考?”

实施安全护栏。 Hallmark 是一项设计技能,不是推平代码库的许可证。在任何现有项目中:

  • 除非用户明确要求删除或批准了包含删除操作的文件级计划,否则绝不删除生产文件、路由树、组件目录或旧网站。
  • 默认对命名文件进行原地编辑,或添加新的组件/令牌并通过现有路由进行连接。如果重新设计需要删除多个组件,请停下来先请求确认。
  • 将 PDF、README 文件、.md 简报、文档、脚本、演示文稿视为参考资料。除非用户明确说明要逐字使用,否则不要逐字复制到页面中。
  • 在编辑之前,陈述你期望修改/创建/删除的确切文件。删除操作需要明确确认。

默认的设计流程总是选择一个主题。默认情况下,它会从 20 个命名主题——这个目录——中选择,并根据多样性规则在它们之间轮换。此外,还有一个安静的自定义分支,它会为当前需求构建一套一次性的 OKLCH 调色板 + 免费字体搭配;自定义路径仅当需求带有创意意图信号时才会触发(用户命名了品牌色,命名了目录无法承载的多属性氛围,或明确请求自定义主题)。对于普通需求,用户永远看不到“目录”或“自定义”这些词——目录静默运行。请参见步骤 1(信号检测)和步骤 2.6(分发);协议存在于 references/custom-theme.md 中。


跨所有动词适用的纪律

以下六项纪律并非特定于某个动词。它们适用于默认设计、audit、redesign、study 以及组件级作用域。它们与“模板检测测试”并列,而不是其内部的一个分支。

  1. 预发射自我批评。 在交出任何输出之前,在六个轴上给自己打 1–5 分:哲学、层级、执行、特异性、克制、多样性。任何 < 3 的分数都会触发一轮修改。在工件的顶部印上这六个分数(/* Hallmark · pre-emit critique: P5 H4 E5 S4 R5 V5 */)。参见 references/slop-test.md § 预发射自我批评。

  2. 诚实内容——不编造。 如果用户没有提供数据,就不要捏造。以数据为主导的布局、对比行、证明条必须使用真实数字、占位符(— 加上标记为“待确认指标”的灰色块)或不同的宏观结构。“转化率提高 47%”、“受 50,000+ 团队信赖”、“快 10 倍” 一旦编造就成为了模板化内容。推荐语、Logo 和案例研究数量同样适用此规则。参见 references/anti-patterns.md § 捏造的数据指标 和 模板检测测试门 46。

  3. 锁定令牌——渲染中途不可即兴发挥。 一旦在步骤 2.6 选择了主题,工件中的每个颜色和每个 font-family 声明都必须引用一个命名令牌(var(--color-accent)、font-family: var(--font-display))。不允许内联的 OKLCH / 十六进制 / rgb() 值,或绕过令牌块的 font-family: "Some Font" 声明。如果需要某个值但现有令牌块中没有,则将其作为新的命名变量提升到令牌块中,然后引用它。参见 references/anti-patterns.md § 渲染中途令牌即兴发挥 和 模板检测测试门 48。

  4. 禁止重绘浏览器组件。 Hallmark 不得手工构建假的浏览器栏(URL 药丸 + 红绿灯点)、假的手机框架、假的代码块窗口(包装 <pre> 的模拟标题栏 + 点)、或假的 IDE 外观——用户的环境已经提供了真实的外观。使用包含在 <figure> 中的真实截图(最多加一个发丝般的边框),或者省略外观让内容自己说话。参见 references/anti-patterns.md § 重绘 UI 外观 和 模板检测测试门 47。

  5. 移动端响应——每次输出需在 320 / 375 / 414 / 768 px 下验证。 Hallmark 的输出必须在所有四种宽度下完美呈现。不可协商的点:无水平滚动 + html 和 body 上均使用 overflow-x: clip,绝不能是 hidden(门 34);无可点击文字折行——按钮、主导航链接、页脚链接、面包屑、CTA(门 49);包含图片的网格轨道必须使用 minmax(0, 1fr),而非裸 1fr(门 50);显示标题应通过 overflow-wrap: anywhere; min-width: 0 处理长词换行(门 51);所有主题变体下,章节标题在移动端必须折叠为一列(门 52);单选标签模式不能滚动跳动(门 53)。参见 references/responsive.md § 移动端——不可协商。这是硬性底线,而非愿望清单。

  6. 排印纯度——无斜体标题。 标题和显示字体始终保持正体(font-style: normal)。在原本正体的标题中出现的斜体强调词(Built to <em>think</em>)是最可靠的 AI 痕迹之一;标题全部使用斜体显示体也是如此。应使用字重、强调色或手绘下划线来承载强调。斜体仅保留在正文段落中作为正文强调。参见 references/anti-patterns.md § 斜体标题 和 模板检测测试门 38a。


当需求是组件而非页面时

在进入完整的设计流程之前,检查范围。如果以下任何信号触发,则运行组件级流程——大多数日常开发请求都是组件形态而非页面形态,而页面级的设施(宏观结构、英雄区丰富化、页脚原型、项目记忆)对它们是不合适的。

组件级信号:

  • 需求命名了一个单一 UI 元素:按钮 · 输入框 · 卡片 · 模态框 · 下拉菜单 · 工具提示 · 选择器 · 复选框 · 开关 · 标签页 · 芯片 · 徽章 · 横幅 · 提示条 · 弹出框 · 滑块 · 日期选择器 · 头像。
  • 需求很短(≤ 30 字)并且仅指一个元素。
  • 目标文件是一个单一组件(例如 ./Button.tsx、./components/Input.css、app/components/Card.vue)。
  • 用户明确说*“只要 X”、“只需要 Y”、“这一个元素”、“单个 ___”*。

如果两个信号触发,路由到组件。如果只有页面流触发(多章节需求,“给我建一个落地页”),则停留在设计流程。

组件级从页面流程保留的部分

  • 步骤 0 · 预检扫描——相同。读取现有令牌、字体、框架、微交互立场。一个在基于 Geist 的 Tailwind 项目中的按钮必须采用这些令牌,而不是发明新的。
  • 步骤 1 · 流派检测——相同。编辑型 / 现代极简 / 氛围型 / 趣味型。组件继承其周围环境的流派(未知时静默默认为编辑型)。
  • 步骤 2.6 · 主题路由——相同。如果存在 tokens.css 或 design.md,组件使用这些令牌。否则询问“是否有要遵循的系统,还是我来选一个?”——如果用户沉默,默认目录。
  • 2+1 字体纪律——相同。
  • 状态纪律——更严格。 每个交互式组件必须为全部 8 种状态提供代码:默认 · 悬停 · :focus-visible · :active · 禁用 · 加载中 · 错误 · 成功。位于 interaction-and-states.md 中的 8 状态清单是强制性的,而非建议性的。
  • 模板检测测试——仅通用子集。 运行视觉 / 微交互 / 对比度(门 40–41)/ 无障碍 / 排印相关门。跳过多样性门(无需 .hallmark/log.json 条目——组件不轮换),并跳过假设为完整页面布局安全门。

组件级跳过的部分

  • 步骤 2 · 宏观结构选择。 组件没有宏观结构。显式说明这一点:“组件级:跳过宏观结构。”
  • 导航和页脚原型选择。 N1–N9 和 Ft1–Ft8 仅为页面级。组件是一个元素;它没有导航,没有页脚。两者都跳过。
  • 英雄区润色模式(HP1–HP4)。 仅为页面级。按钮或卡片没有英雄区。
  • 步骤 4 · 丰富化。 没有英雄区插图,没有演示视频,没有抽象背景。组件本身就是工件。
  • 步骤 5 · 多章节预览。 替换为下面的 8 状态演示包装器。
  • 项目记忆追加。 组件运行不产生 .hallmark/log.json 条目。多样性规则不适用。

组件级的输出内容

两个文件,并排放置:

  1. 组件工件——一个符合项目约定的自包含文件:

    • React / Vue / Svelte: Button.tsx / Button.vue / Button.svelte
    • Vanilla web: button.css + button.html
    • Tailwind: 一个带 className 链的 .tsx 文件,如果缺少 tokens.css 则一并创建
    • 组件按名称使用 Hallmark 令牌(var(--color-accent)),绝不内联 OKLCH 值。
  2. 一个 8 状态演示包装器——<ComponentName>.preview.html(或 .preview.tsx)。一个独立的小页面,垂直堆叠渲染组件的全部 8 种状态,每种状态带有标签。用户打开一次,看到组件工作正常,然后删除它。包装器不属于生产代码。格式:

    ┌──── Button — 8 种状态 ──────────────────────┐
    │                                                │
    │ 默认        [ 点击我                      ]    │
    │ 悬停        [ 点击我                      ]    │  ← .is-hover 强制触发 :hover 样式
    │ 聚焦        [ 点击我                      ]    │  ← .is-focus 强制触发 :focus-visible
    │ 激活        [ 点击我                      ]    │  ← .is-active 强制触发 :active
    │ 禁用        [ 点击我                      ]    │  ← disabled 属性
    │ 加载中      [ ⌛ 工作中…                  ]    │  ← data-state="loading"
    │ 错误        [ ⚠ 重试                      ]    │  ← data-state="error"
    │ 成功        [ ✓ 已保存                    ]    │  ← data-state="success"
    │                                                │
    └────────────────────────────────────────────────┘
    

    每个带标签的行使用一个类(例如 .is-hover),组件的 CSS 除了针对真正的伪类外也针对这个类,以便在演示页面上所有 8 种状态同时渲染。示例:

    .btn:hover, .btn.is-hover { background: var(--color-paper-3); }
    .btn:focus-visible, .btn.is-focus { outline: 2px solid var(--color-focus); }
    .btn:active, .btn.is-active { transform: translateY(1px); }
    

组件输出的标记格式

组件的标记与页面不同:

/* Hallmark · 组件: <类型> · 流派: <流派> · 主题: <主题>
 * 状态: 默认 · 悬停 · 聚焦 · 激活 · 禁用 · 加载中 · 错误 · 成功
 * 对比度: 通过 (46–50)
 */

组件: 前缀告知未来的 Hallmark 运行,此工件是组件级作用域,不应触发页面级的多样性检查和日志记录。

相关技能