Hallmark 的边界：contract.md 如何定义 taste 技能不做什么（完整解读）

Hallmark 的边界contract.md 如何定义 taste 技能不做什么完整解读【免费下载链接】hallmarkAnti-AI-slop design skill for Claude Code, Cursor, and Codex.项目地址: https://gitcode.com/GitHub_Trending/hal/hallmarkHallmark 是一款面向 Claude Code、Cursor 与 Codex 的反 AI 味anti-AI-slopUI 设计技能它用一套紧凑的规则集阻止 AI 生成一眼假的模板化界面。而真正让这套规则集可信的是一份只有 20 多行的小文件——contract.md它几乎不教模型做什么而是明确定义这个 taste 技能不做什么。对新手来说读懂这份负面清单是理解 Hallmark 设计技能工作方式的最快路径。什么是 Hallmark一个有主见的设计技能Hallmark 的官方自我定位是opinionated有主见、short短小、boring on purpose刻意无聊见 SKILL.md#L11。它在为每个项目生成界面时会先挑选一种宏观结构macrostructure共 21 种页面骨架再套用 22 个命名主题之一最后通过 slop-test 关卡与交付前自评拦截AI 味一句话概括Hallmark 管的是好不好看、像不像人做的不管功能对不对。这份 contract.md 就是这条分界线的正式声明。contract.md 是什么交接时加载一次的契约文件在 Hallmark 的文件体系里contract.md 开头就写明了自己的定位Loaded once per build, at handoff time每次构建、在交接时刻加载一次。也就是说它不是生成时的参考书而是交付前的最后一道验收单。全文只有两个小节小节回答的问题Output contractL5–L13交付物必须长什么样Scope and limitsL15–L24这个技能管到哪里为止输出契约5 条可验证的交付规则Output contract一节只有 5 条规则contract.md#L7-L13但条条可执行设计 token 只放一处——集中在样式表顶部:root自定义属性或独立的tokens.css/tokens.ts文件里按语义角色命名不按值命名——写--color-ink而不是--color-blackTailwind 项目只扩展主题——禁止在各组件里内联任意值遵守框架的文件约定——项目用什么框架就按那个框架的习惯来不重造轮子样式表顶部只写一段注释——注明 genre、用户选定的 tone、色板锚色相与结构指纹这是你唯一需要的注释。这 5 条的共同点它们都是可机械检查的。下次运行 Hallmark 时技能会读回这些 token 和注释继续在同一套设计系统上迭代——这正是它坚持结构多样性而非换皮多样性的底层机制。范围边界taste 技能的 4 条不做什么这才是 contract.md 的灵魂。Scope and limits一节第一句就立下了基调contract.md#L17Hallmark is atasteskill. It will not: —— Hallmark 是一个品味技能。它不会随后列出 4 条硬性边界contract.md#L19-L221️⃣ 不代写产品文案If the user hasnt given you the words, ask.用户没给文案就开口问。技能不会替你发明一句 slogan更不会编造47% 转化率这类假数据——这与 SKILL.md 中Honest copy — no fabricated content的纪律互为表里。2️⃣ 不挑选品牌识别It will follow one you give it.你给什么品牌它跟什么。品牌是用户的主权技能只做执行者不越位当品牌顾问。3️⃣ 不强制特定风格Dark mode、玻璃拟态glassmorphism、粗野主义brutalism……contract.md 明确拒绝替用户钦定风格It will execute whichever genre tone the user committed to.执行用户已选定的 genre tone 即可。风格由用户在需求阶段拍板技能负责把它做到位。4️⃣ 不构建业务逻辑状态管理、数据抓取、业务规则——全部不在范围内。It is a visual / interaction layer only.它只是一层视觉/交互层。越界请求怎么办做但把 Hallmark 用在渲染面边界不等于拒绝服务。contract.md 的最后一句contract.md#L24给出了优雅的兜底方案If a request falls outside taste — build the auth flow, wire up Stripe — do the work, but apply Hallmark to the rendered surface.翻译成中文如果请求超出了品味范畴——比如搭一个登录流程接上 Stripe 支付——活照干但 Hallmark 只作用于最终渲染出来的界面层。逻辑归逻辑审美归审美各归其位。为什么明确不做什么反而让 AI 设计技能更可靠对新手而言这一节可能是全文最有价值的设计思想压缩自由发挥空间。大模型最容易在规则没提到的地方放飞自我负面清单等于提前划好了雷区✅职责可验收。4 条不做什么都是二值判断——做没做越界一眼可查不需要主观打分与规则体系分工清晰。生成期的禁止项在 anti-patterns.md 与 slop-test 关卡slop-test.md里交接期的契约收拢在这份 20 多行的 contract.md 中互不越权️守住代码库安全。SKILL.md 中的Implementation safety railSKILL.md#L32-L36进一步声明它是设计技能不是推平代码库的许可证。延伸阅读技能主文件设计流程全貌skills/hallmark/SKILL.md本文主角——输出契约与范围边界skills/hallmark/references/contract.md反模式清单生成期禁止项skills/hallmark/references/anti-patterns.md8 个完整实战案例人读docs/recipes.mdDNA 提取示例人读docs/study-examples.md总结contract.md 用不足 25 行文字回答了AI 设计技能该管到什么程度——token 必须集中且语义化、文案品牌风格逻辑都不替用户做主、越界请求照做但只美化渲染面。这份克制的负面契约正是 Hallmark 区别于普通让 AI 写点漂亮 CSS提示词的地方。【免费下载链接】hallmarkAnti-AI-slop design skill for Claude Code, Cursor, and Codex.项目地址: https://gitcode.com/GitHub_Trending/hal/hallmark创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考