UI Craft 是一个面向网页 UI 设计与实现的设计工程规范,定位为避免产出“AI 感”通用的界面。它强调每个设计决策都应有依据、可解释,而非沿用默认。
【工作方式】 UI Craft 以“阶梯”描述使用深度:Rung 0 Ask(默认提供基本审美与合理层级)、Rung 1 Direct(用 /craft、/critique、/polish、/animate 等命令做单次聚焦处理)、Rung 2 Persist(用 /brief、/tokens、/remember 建立跨会话的设计上下文)、Rung 3 Enforce(用 /finalize、审查代理、MCP 门禁、评分与 ui-craft-detect 防止退化)。/sddesign 不是阶梯,而是为单个大型界面走完 Rung 1 到 3 的快捷通道。
【可调参数】 Discovery 阶段可询问 1-10 参数:CRAFT_LEVEL(精修深度,默认 7)、MOTION_INTENSITY(动效强度,默认 5)、VISUAL_DENSITY(视觉密度,默认 5)、DESIGN_VARIANCE(设计变化度,仪表盘默认 4、落地页 7、作品集 8)。参数仅作为用户未明确时的回退默认值。
【主要规则】 先询问再假设,不默认强调色、字体或风格;默认句首大写;90% 以上为中性色加一个强调色,且不默认蓝色;圆角按层级变化;使用真实 SVG 图标而非 emoji;大标题收紧字距;正文一种字体,可另加展示字体;用分层阴影替代扁平边框;退出动画快于进入动画;强调色在首屏视口内控制在 3-5 处;每个区块都要有存在理由;每个 UI 保留一个标志性细节。
【流程】 先做技术栈检测(Tailwind、CSS Modules、styled-components、CSS-in-JS、SFC、原生 CSS),不违背项目栈、不混用方案;再进行 Discovery:读取 .ui-craft/ 下的 brief.md、tokens.md(按需加载 decisions.md、patterns.md、surfaces/<name>.md),扫描已有 token 系统,缺失时询问风格、强调色、字体、动画栈;随后输出 Craft Read 再写代码。
【路由与命令】 提供 /start、/brief、/tokens、/sddesign、/craft、/critique、/polish、/harden、/distill、/redesign、/bolder、/quieter、/extract、/delight、/clarify、/adapt、/audit、/shape、/unhappy、/heuristic、/finalize、/remember 等命令,并可按需参考 motion、layout、typography、color、accessibility、copy、responsive、metadata、dataviz、state-design、forms、components、loops、stack 等文档。若连接了 ui-craft MCP 服务器,可先调用 route_task 获取按任务排序的参考与工具。
【适用范围与限制】 UI Craft 只覆盖网页端视觉与交互层;代码编辑器界面、原生移动应用、实时协作界面、HTML 邮件不在范围内,应改用对应工具。营销文案与 SEO 策略分别交给文案与 SEO 技能,UI Craft 只负责已输出元数据的正确性。具体实现细节、命令语义与文件格式以项目资料为准,部分内容暂未提供。