Communitygithub.com

Craft

用于设计、创建、模拟或重新设计页面、屏幕、流程或UI元素。它从项目简报出发,覆盖所有状态,仅在方向开放时提供选项,仅使用设计系统的组件,并在展示前自我检查。

Craft 是什么?

Craft 是一个面向视觉设计的智能体技能,适用于 Claude Code、Cursor 或 Codex 等 AI 编码助手平台。它的核心作用是将“设计定价页面”这样的模糊需求转化为一个完整、经过评审的设计方案。技能严格遵循项目根目录下的 `DESIGN.md` 简报,覆盖所有状态(通过 `craft-states` 子技能),并在方向不明确时通过 `craft-explore` 提供选项,避免在已解决的模式上浪费精力。Craft 强制使用已有的设计系统组件和令牌(token),任何新的组件或颜色必须先通过 `craft-system` 子技能添加,防止局部硬编码导致样式漂移。在展示结果前,它会自动调用 `craft-critique` 进行自我审查。对于多页面的请求,Craft 会先要求确认范围,再逐项处理。所有决策都会记录到 `DESIGN.md` 的决策日志中,确保后续会话可追溯。

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

在你喜欢的 AI 中提问

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

文档

Craft 是做什么的?

概述

制作任何视觉内容的前门。它把“设计定价页面”变成一份完整、经过评审的设计。它从项目简报出发,覆盖每个状态,仅在方向开放时提供选项,只使用设计系统的组件,并在展示前自我检查。它在固定节点调用其他设计技能,并不替代它们。

使用时机

  • “设计/创建/模拟/重新设计 <页面、屏幕、流程、元素>”,/craft(在 Claude Code 插件中为 /craft:craft)。
  • 同时设计多个页面(“设计 onboarding:欢迎、注册、验证”)。

不要使用时

  • 用户精确描述的小修改(一个值、一个标签、一个尺寸):直接修改。
  • 仅需评审(“这个有什么问题?”):使用 craft-critique。仅需选项:使用 craft-explore。

开始之前

  • 如果 references/adapters/ 中没有与你的工具匹配的适配器,请在你的工具中执行相同操作,并说明你是手动映射的。如果没有设计工具,则用 HTML 构建(html.md)。如果只有图片,请注明从中读取的值是估算值。

停止是真实的

停止意味着:以问题结束你的回合并等待。即使在一次性或无头会话中,你始终可以这样做,此时你的最后一条消息就是问题。永远不要因为会话“不能等”或“节省一次往返”而代替用户做决定。 自行决定会把你只需要五秒钟就能解决的问题变成数小时的返工。

步骤

  1. 上下文。
    • 阅读项目根目录下的 DESIGN.md。如果缺失,或者没有“产品”部分(仅同步记录)→ 必需子技能:craft-setup,然后返回此处。
    • 阅读设计系统(令牌、组件、指南)以及与此页面相关的屏幕。
    • 当简报与代码不一致时(简报说青色,令牌说蓝色):遵循代码,用一句话说明,将冲突添加到 DESIGN.md 的“未决问题”部分,并提供更新错误一方的选项。永远不要覆盖页面自身 CSS 中的令牌。
    • 当设计工具的指南与代码不一致时,如果存在 design-sync.json,不要认为指南已过时。按以下方式分类:代码更改 → 提供在绘制前刷新指南的选项;指南更改 → 这是用户等待导出的更改,因此使用指南绘制并提及待处理的导出。
  2. 用文字描述范围。 列出要制作的每个页面或元素,包括其职责和下一个操作。
    • 含糊的词语给出明确的解释(“定价页面 = 烘焙店的价目表,不是订阅计划”)。
    • 当请求包含多个项目或模糊不清时,停止并确认列表。 一个明确的项目:继续。
  3. 按顺序处理每个项目:
    1. 必需子技能:craft-states。 其书写的状态列表及其停止先进行。
    2. 方向是否开放? 仅当用户要求创意时,或当两种结构不同的布局都合理且简报与系统均未做选择时,→ 必需子技能:craft-explore,然后再绘制状态。对于多个页面,在范围确认停止处询问哪个页面(如果有)需要选项;默认情况下,不要为每个页面运行一轮选项。状态随后在选定的方向上绘制。遵循现有模式的屏幕直接进入绘制。
    3. 绘制主状态,然后绘制其他状态,仅使用系统的组件和令牌。新内容(组件、颜色、比例中不存在的尺寸)→ 必需子技能:craft-system(添加模式),然后再使用。如果某个组件在代码中存在但未在设计工具中绘制(索引中标记为“仅代码”),→ 必需子技能:craft-sync(导入一个组件),先绘制该组件。如果用户拒绝了导入(参见 DESIGN.md),在导入前询问一次;如果他们仍然拒绝,则根据板上的代码值构建并记录。永远不要绘制近似值,也永远不要在页面中硬编码新值。
    4. 在自我检查模式下运行必需子技能:craft-critique 到每个画板上:渲染,修复在此任务范围内发现的问题,并再次渲染。
  4. 结束。
    • 使用下面的摘要展示结果。
    • 将决策附加到 DESIGN.md › 决策日志(日期、决策、原因)。
    • 将已回答的问题移出“未决问题”。

结束摘要(最终消息的格式)

制作了:<页面/元素> — <位置:文件或画板>
决策:<每个决策一行,附原因>(也在 DESIGN.md › 决策日志中)
系统更改:<添加或更改的组件/令牌> — 影响:<屏幕>
自我检查修复了:<craft-critique 在你看到之前更改了哪些>
未决问题:<用户仍需决定的事项>

规则

规则原因
每次必须先检查 DESIGN.md没有简报,每个屏幕都会发明自己的样式
当请求多于一个项目时,先确认范围再开始工作构建三个错误的页面等于浪费三次工作
在绘制状态列表之前(通过 craft-states)正常路径只是众多状态之一
仅在方向开放时提供选项在已解决的模式上提供选项会浪费用户的注意力
仅使用系统组件和令牌;新内容需要通过 craft-system页面中的硬编码值是样式漂移的起点
代码优于过时的简报;记录差异,不要覆盖令牌是实际发布的内容;简报通过决策更新,而不是静默更新
在展示前自我检查用户应该评审设计,而不是捕捉错误
决策写入 DESIGN.md下次会话的设计从这些决策开始,而不是从记忆开始

完成条件

确认范围内的每个项目都已绘制其状态并完成自我检查,所有系统更改已通过 craft-system,已提供结束摘要,并且 DESIGN.md 的决策日志已更新。

常见错误

想法实际做法
“三个页面很清楚,我就直接构建吧”先确认列表。这只需要一条消息。
“这里我把按钮做成 52px;令牌说是 44,但这个受众需要更大的”这是系统决策。通过 craft-system 提出建议,然后在所有地方使用。
“简报说青色,所以我在这个页面的 CSS 中覆盖蓝色”代码优先。标记冲突并询问;永远不要局部修补令牌。
“我先展示,他们会告诉我哪里有问题”先运行 craft-critique 进行自我检查,并说明修复了什么。
“决策都在我的消息里,这样就够了”消息会滚动消失。将它们追加到 DESIGN.md。
“这个会话不能停下来等回答,所以我自己决定并列出它们”以问题结束你的回合就是停止。这样做;在第一个开放停止之后不要构建任何东西。
“为了节省一次往返,我把两个停止放在一条消息里”可以,但之后你必须停止。同时问两个问题,不构建任何东西,等待。

Individual skills in this repo

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

相关技能