## 项目概述 Hallmark 是一个面向 Claude Code、Cursor 和 Codex 的“设计技能”（design skill），目标是让 AI 生成的界面不再带有明显的 AI 痕迹（anti-AI-slop）。它由 Together AI 团队开源，仓库语言标记为 CSS，采用 MIT 许可证。 Hallmark 会根据任务为页面选择“宏观结构”（macrostructure），套用 21 种主题之一，并通过 57 道“AI 痕迹检测门”（slop-test gates）和输出前的自我批评来避免模型默认风格。不同需求生成的页面在结构上会有明显差异，而不是同一模板换色。 ## 核心功能 - 默认行为：根据 brief 构建新 UI，选择宏观结构、应用规则集、运行 slop 测试后返回结果。 - `hallmark audit `：对已有代码按反模式打分，给出整改清单，但不直接修改代码。 - `hallmark redesign `：保留文案、信息架构和品牌，推翻原有结构并用不同的设计指纹重建。 - `hallmark study `：从用户欣赏的设计中提取“DNA”（宏观结构、字体搭配、色彩锚点等），拒绝像素级克隆和付费模板；可选输出可移植的 `design.md`。 - 内置 21 种主题、57 道 slop-test 门禁、输出前自批评机制，以及 `.hallmark/log.json` 项目记忆以避免连续生成雷同设计。 - 当 brief 包含现有主题无法覆盖的创意意图时，可进入 Custom 模式从零设计页面。 - 仓库提供多个已生成示例页面，全部为自包含 HTML + CSS。 ## 适用与不适用场景 适用场景： - 在 Claude Code、Cursor、Codex 等 AI 编程工具中需要生成新 UI 时。 - 希望页面不是千篇一律的 SaaS 模板风格，而是有结构差异的定制设计。 - 希望对已有界面进行“AI 痕迹”审计或在不改变文案/品牌的前提下重新设计。 - 希望通过截图学习某个设计的结构 DNA，而非复制像素。 不适用场景： - 想要 1:1 像素级复制某个网站或设计稿。 - 想要复制付费模板或受版权保护的页面（技能会拒绝此类请求）。 - 需要的是后端、数据或非 UI 类功能，而非前端界面设计。 - 没有 AI 编程助手环境，或期望它作为独立网页应用运行。 ## 技术架构与依赖 - 这不是一个独立应用或框架，而是以“技能包”形式分发的规则集。 - 核心文件为 `SKILL.md` 及 `references/` 目录中的参考文档，包括 custom-theme、study、排版、微交互等主题的规则。 - 产出物为自包含 HTML + CSS 页面。 - 安装依赖 `npx skills add nutlope/hallmark` 或手动复制技能文件；具体运行时依赖清单仓库资料未提供。 - 仓库同时包含 `docs/recipes.md`、`docs/study-examples.md`、`docs/talk-slides.md` 和 `site/` 下的示例页面。 ## 安装与快速开始 安装命令（来自 README）： ```bash npx skills add nutlope/hallmark ``` 重新运行同一命令即可更新。也可手动复制 `SKILL.md` 和 `references/` 到对应目录： - Claude Code：`~/.claude/skills/hallmark/` - Cursor：`.cursor/rules/hallmark.mdc`（仅使用 `SKILL.md` 正文，不含 frontmatter） - Codex：`~/.codex/skills/hallmark/`（个人）或 `.codex/skills/hallmark/`（项目级） 快速开始示例（来自 recipes.md 的 canonical try-it prompt）： > “Build me a landing page for Coffeebox — a small-batch coffee subscription. Roast on Sunday, ship on Monday, drink Tuesday. Audience: people who already buy good coffee and want fewer trips to the shop. Tone: warm, hand-set, editorial — like a small café's chalkboard.” 如果安装正确，Hallmark 应生成与该 brief 相符的、非模板化的页面。 ## 典型使用方法 - 新建 UI：直接描述受众、用途、语气和内容，让 Hallmark 选择宏观结构、主题和视觉细节。 - 审计现有界面：运行 `hallmark audit `，得到反模式清单和整改建议，不改动代码。 - 重新设计：运行 `hallmark redesign `，保留原有文案和品牌，换一套结构指纹重建。 - 学习参考设计：运行 `hallmark study `，先返回诊断报告（宏观结构、字体角色、色彩锚点、密度等），确认后再重建；它不会复制像素，也不会直接给出付费字体 ID，而是建议免费替代字体。 - 项目记忆：`.hallmark/log.json` 会记录历史选择，避免同一项目重复生成同样结构或主题。 更完整的可直接粘贴的 prompt 示例见 `docs/recipes.md`。 ## 配置与部署要点 - 按安装目录放置技能文件；Cursor 的 `.mdc` 文件需要去掉 frontmatter。 - 技能规则集位于 `SKILL.md` 和 `references/`；Custom 模式协议位于 `references/custom-theme.md`。 - 若需要跨工具/项目传递设计 DNA，可让 `hallmark study` 输出可移植的 `design.md`。 - Hallmark 会拒绝部分来源（付费模板市场、带版权保护的页面、像素级克隆请求），并会在使用付费字体替代方案时明确说明。 - 该技能面向本地 AI 编程助手，不涉及服务器部署；若要在团队内分发，可直接复制技能目录或通过 `npx skills add` 安装。 ## 限制、风险与许可证 - 许可证：MIT，可自由使用、fork 和发布。 - 限制：它主要处理设计/前端 UI 生成与重构，不提供完整应用后端能力。 - 限制：视觉字体识别不可靠，因此技能通常描述“字体角色”并建议免费替代方案，而不是直接指定付费字体 ID。 - 风险：文档说明项目记忆机制用于降低连续生成雷同设计的概率，但并未承诺每次输出绝对唯一。 - 风险：输出质量与所运行模型及执行环境有关；仓库资料未提供最低模型版本要求。 - 未提供的部署、维护或商业支持信息：仓库资料未提供。 ## 官方链接 - GitHub 仓库：https://github.com/nutlope/hallmark - Live demo：https://www.usehallmark.com - 使用示例：https://www.usehallmark.com/examples/ （另有 `site/_tests/`） - 配方示例：`docs/recipes.md` - study 示例：`docs/study-examples.md` ## 信息来源和分析时间 - 信息来源：GitHub 仓库元数据（owner、name、language、license）、README.md、docs/recipes.md、docs/study-examples.md、docs/talk-slides.md。 - 分析时间：仓库资料未提供具体快照日期；本次分析基于所提供的仓库快照内容整理。