Communitygithub.com

craft-setup

当项目根目录没有 DESIGN.md 时,用于启动设计流程:定义产品风格、品牌指引或设计规范,或运行 /craft-setup (/craft:craft-setup in the Claude Code 插件)。

craft-setup 是什么?

craft-setup 技能用于在项目设计流程开始时,建立设计基础文档并采集关键决策。它通过先阅读现有文档(如 README、CSS 变量、Token 文件、组件库等),避免提出文件中已明确的问题;然后以“每次提出一个问题”的方式,按照预定义的采访顺序(产品、受众、语态、情绪、品牌、参考、约束)与用户逐一确认设计方向。每当可提供选项时,应给出 3-5 个选择再加一个“其他”。它要求用户提供 2-5 个参考案例,并针对每个案例明确“可取之处”和“避免之处”。生成的 DESIGN.md 包含产品、受众和语态、情绪、品牌、参考、约束、决策日志和未解决问题共 8 个部分,不仅记录确认的事实,还将所有推断内容标记为“(假设)”或放入“未解决问题”中,确保品牌不是由 AI 凭空制造。若项目代码中已有设计系统(如 UI 包、token 文件、组件库),则识别其路径并跳过相应的品牌问题,并提供导入设计工具的选择。如果用户要求“跳过”或“直接设计”,则仅生成最小化的 DESIGN.md(所有空白为未解决问题、所有推断标记为“(假设)”),但仍需要完成基础层(token、排版、间距、交互规则)的创建或导入步骤。该技能适用于 Claude Code、Cursor、Codex 等支持自定义技能的 AI 编码代理,要求每次只提一个问题、保留用户原词、并始终提供参考案例的“可取/避免”分析。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/craft/tree/HEAD/skills/craft-setup

在你喜欢的 AI 中提问

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

文档

设计设置

概述

在第一屏之前,先明确产品是什么、为谁而做、应该给人什么感觉、绝对不能长什么样。将这些记录在 DESIGN.md 中——这是后续所有设计决策优先读取的简介。提问,而非编造:由 AI 代理臆造的品牌只不过是一个需要用户反复修正的猜测。先阅读已有内容,逐一向用户提问,撰写简介,等待批准,然后构建基础层。

何时使用

  • 有设计任务,但项目根目录没有 DESIGN.md。
  • “设置设计”、“定义我们的风格/品牌/指引”、/craft-setup (/craft:craft-setup in the Claude Code 插件)。

何时不使用

  • DESIGN.md 存在且任务是设计任务:使用 craft。
  • 仅修改一个 token 或一条指引:使用 craft-system。

步骤

  1. 先阅读。 README、文档、已有的 CSS 或 token、设计文件、品牌文件夹、任何旧版的 DESIGN.md 草稿。记录已有答案。如果代码中已有设计系统(UI 包、token 文件、组件库),说明其内容(给出数量),并在简介的“品牌”部分写“设计系统来源:<路径>”。在第 6 步中,提供将其导入设计工具的选项,而不是创建基础层;它已回答的品牌问题将被跳过。 两个 UI 包 → 在跳过任何品牌问题之前,询问哪个是来源。绝不问文件中已回答的问题。 用一句话确认即可(“你的 README 说仅限 pt-BR 且成员年龄超过 60,所以我会设计 18px 文字和 48px 触控区”)。
  2. 采访,每一条消息只提一个问题。 按照采访参考的顺序:产品、受众和语态、情绪、品牌、参考、约束。
    • 只要可能,提供 3-5 个选项加一个“其他”。
    • 跳过任何已经回答的问题。
    • 当答案足以设计第一屏时就停止。六个好的答案胜过十五个。
  3. 参考是必需的。 要求提供 2-5 个用户喜欢的产品、网站或图片。对于每一个,询问要采用什么以及要避免什么。如果它是可打开的链接或图片,先查看并说出你看到的内容,然后再提问。
  4. 编写 DESIGN.md 放在项目根目录,基于模板,包含全部八个部分:产品、受众和语态、情绪、品牌、参考、约束、决策日志、未解决问题。
    • 尽可能使用用户的原文。
    • 任何你推断但用户未确认的内容,放入“未解决问题”中,而不是作为事实写入简介。
  5. 暂停并向用户展示 DESIGN.md。 根据用户反馈修改,直到获得批准。
  6. 基础层。
    • 代码中已有设计系统: 提供导入选项。如果选择“是”,必需的子技能: 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 很乱,我来重构一下”扩展它们。重构是一项独立的、经批准的变更。
“没有给出参考,我跳过那部分”要求提供参考。如果他们确实没有,提供三个符合情绪的参考并询问从每个参考中采用什么、避免什么。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能