设计设置
概述
在第一屏之前,先明确产品是什么、为谁而做、应该给人什么感觉、绝对不能长什么样。将这些记录在 DESIGN.md 中——这是后续所有设计决策优先读取的简介。提问,而非编造:由 AI 代理臆造的品牌只不过是一个需要用户反复修正的猜测。先阅读已有内容,逐一向用户提问,撰写简介,等待批准,然后构建基础层。
何时使用
- 有设计任务,但项目根目录没有
DESIGN.md。 - “设置设计”、“定义我们的风格/品牌/指引”、
/craft-setup(/craft:craft-setupin the Claude Code 插件)。
何时不使用
DESIGN.md存在且任务是设计任务:使用craft。- 仅修改一个 token 或一条指引:使用
craft-system。
步骤
- 先阅读。 README、文档、已有的 CSS 或 token、设计文件、品牌文件夹、任何旧版的
DESIGN.md草稿。记录已有答案。如果代码中已有设计系统(UI 包、token 文件、组件库),说明其内容(给出数量),并在简介的“品牌”部分写“设计系统来源:<路径>”。在第 6 步中,提供将其导入设计工具的选项,而不是创建基础层;它已回答的品牌问题将被跳过。 两个 UI 包 → 在跳过任何品牌问题之前,询问哪个是来源。绝不问文件中已回答的问题。 用一句话确认即可(“你的 README 说仅限 pt-BR 且成员年龄超过 60,所以我会设计 18px 文字和 48px 触控区”)。 - 采访,每一条消息只提一个问题。 按照采访参考的顺序:产品、受众和语态、情绪、品牌、参考、约束。
- 只要可能,提供 3-5 个选项加一个“其他”。
- 跳过任何已经回答的问题。
- 当答案足以设计第一屏时就停止。六个好的答案胜过十五个。
- 参考是必需的。 要求提供 2-5 个用户喜欢的产品、网站或图片。对于每一个,询问要采用什么以及要避免什么。如果它是可打开的链接或图片,先查看并说出你看到的内容,然后再提问。
- 编写
DESIGN.md放在项目根目录,基于模板,包含全部八个部分:产品、受众和语态、情绪、品牌、参考、约束、决策日志、未解决问题。- 尽可能使用用户的原文。
- 任何你推断但用户未确认的内容,放入“未解决问题”中,而不是作为事实写入简介。
- 暂停并向用户展示
DESIGN.md。 根据用户反馈修改,直到获得批准。 - 基础层。
- 代码中已有设计系统: 提供导入选项。如果选择“是”,必需的子技能:
craft-sync(导入)。它会展示库存并询问抽取哪些组件。如果选择“否”,在“决策日志”中记录“<日期> — 导入到 <工具> 被拒绝”。即使在“跳过”之后也提供此选项:这是关于设计工具,而非简介。 - 代码中没有系统: 必需的子技能:
craft-system以创建模式运行,用于基础层(token、排版、间距、交互规则)。它有自身的批准停止点。 - 已有的 token 和样式是起点:扩展它们,未经询问不得重命名或移动。
- 代码中已有设计系统: 提供导入选项。如果选择“是”,必需的子技能:
如果用户说“跳过”或“直接设计”
不要继续追问。根据已阅读的内容和用户说过的话编写最小化的 DESIGN.md:
- 每个空白变为一个“未解决问题”;
- 每个假设标记为“(假设)”。
用一句话说明哪些假设最重要。“跳过”免除采访和简介的批准停止,但绝不跳过第 6 步:
- 代码中有设计系统 → 仍然问那一个导入问题(“现在将其导入到 <工具> 中?我会展示已有内容,你选择组件”),然后继续;
- 还没有 token → 基础层步骤及其停止仍然执行,因为
craft只能使用系统部件来绘制。
然后继续执行用户要求的任务。
开始之前
- 如果
references/adapters/中没有与你工具匹配的适配器,仍用你的工具执行同样的操作,并说明你手动映射了哪些。如果根本没有设计工具,就用 HTML 构建 (html.md)。如果你只有一张图片,说明从中读取的值是估算值。 DESIGN.md是所有工具中项目仓库里的纯 Markdown 文件。只有可选的参考看板存放在设计工具中。
规则
| 规则 | 原因 |
|---|---|
| 每一条消息一个问题,附带选项 | 一列问题会被扫读且仅得到一半的回答 |
| 先阅读,再提问;绝不问文件中已说明的内容 | 问 README 里已有的内容表明你没看 |
| 不编造品牌:颜色、字体和情绪必须来自用户,或标记为“(假设)” | 编造的品牌是一个需要用户逐屏修正的猜测 |
| 参考始终附带“采用/避免” | “我喜欢 Stripe” 没什么用;“采用它宁静的间距,避免它的渐变” 才是一条规则 |
| 明确询问“绝不喜欢的” | 要避免什么比要追求什么更能快速缩小设计范围 |
| 在设置过程中不重新设计现有文件 | 设置记录决策;修改他们的 CSS 是一个他们尚未要求的独立设计任务 |
| 设置期间不展示屏幕 | 屏幕来自 craft,在简介和基础层获得批准之后 |
完成标志
DESIGN.md 获得批准(包含全部八个部分),且基础层已确定:通过 craft-system 创建并批准,或在有代码中系统时通过 craft-sync 导入(或拒绝导入并记录)。如果是“跳过”场景:DESIGN.md 已编写(标记假设),基础层已存在(已批准或已在项目中),原始任务已继续进行。
常见错误
| 想法 | 现实 |
|---|---|
| “我选一个漂亮的调色板和字体,他们可以改” | 他们无法修改那些根本不知道已被决定的内容。要么问,要么标记为“(假设)”。 |
| “趁我在这儿,顺便把主要屏幕的模型做出来” | 那是 craft 的工作,在批准之后。设置止于简介和基础层。 |
| “让我一次问完六个问题来节省时间” | 一次一个消息,附带选项。这样对他们来说回答更快。 |
| “他们的 token 很乱,我来重构一下” | 扩展它们。重构是一项独立的、经批准的变更。 |
| “没有给出参考,我跳过那部分” | 要求提供参考。如果他们确实没有,提供三个符合情绪的参考并询问从每个参考中采用什么、避免什么。 |
完成标志
DESIGN.md 已获得批准(包含全部八个部分),且基础层已确定:通过 craft-system 创建并批准,或在有代码中系统时通过 craft-sync 导入(或拒绝导入并记录)。如果是“跳过”场景:DESIGN.md 已编写(标记假设),基础层已存在(已批准或已在项目中),原始任务已继续进行。
常见错误
| 想法 | 现实 |
|---|---|
| “我选一个漂亮的调色板和字体,他们可以改” | 他们无法修改那些根本不知道已被决定的内容。要么问,要么标记为“(假设)”。 |
| “趁我在这儿,顺便把主要屏幕的模型做出来” | 那是 craft 的工作,在批准之后。设置止于简介和基础层。 |
| “让我一次问完六个问题来节省时间” | 一次一个消息,附带选项。这样对他们来说回答更快。 |
| “他们的 token 很乱,我来重构一下” | 扩展它们。重构是一项独立的、经批准的变更。 |
| “没有给出参考,我跳过那部分” | 要求提供参考。如果他们确实没有,提供三个符合情绪的参考并询问从每个参考中采用什么、避免什么。 |