diego3g/craft
开发工具面向 AI 编程 Agent 的设计技能集,引导其按设计系统产出状态完整、风格一致的界面。
项目介绍
craft 把一套设计流程封装成 AI 编程 Agent 可调用的技能。用户不再直接向 Agent 要「一个定价页」然后拿到临时拼凑的结果,而是让 Agent 先写简短设计简报、列出屏幕可能出现的所有状态、复用已有设计系统的组件,并在展示前自我评审。它面向 Claude Code、Codex、OpenCode、Cursor、Gemini CLI 等 Agent 的使用者,适合希望 Agent 产出的 UI 更一致、更完整的开发者。
这些技能与具体工具解耦:技能描述「创建画板」「渲染并查看」等动作,再由适配器映射到 Paper(MCP)、Figma(MCP)或纯 HTML,纯 HTML 是兜底方案。README 说明 Figma 适配器尚未经过测试。
安装
在 Claude Code 中作为插件安装,于会话内执行 (L30-L33):
/plugin marketplace add diego3g/craft
/plugin install craft@craft
插件会添加会话启动钩子,自动把请求路由到对应技能;技能名带插件前缀(/craft:craft、/craft:craft-setup 等)。之后可用 claude plugin update craft@craft 更新。Claude Desktop 或 claude.ai 用户在 Customize › Plugins › Add › Add marketplace 中填入 diego3g/craft。
其他 Agent 通过 skills CLI 安装 (L45-L47):
npx skills add diego3g/craft -a codex
把 codex 换成 opencode、cursor、gemini-cli、github-copilot 或 windsurf,省略 -a 则交互式选择。加 -g 表示安装到所有项目,之后用 npx skills update 更新。这些 Agent 不会运行会话启动钩子,需要把 README 中的路由表粘贴到 AGENTS.md,Agent 才能选对技能。
使用流程
- 每个项目运行一次
craft-setup。它会逐个询问产品、受众、氛围、品牌、参考和约束,然后生成DESIGN.md并搭建基础 token 与组件。 - 让
craft设计页面、屏幕、流程或元素。它会先确认范围和状态清单,再开始绘制。 - 需要备选方向时用
craft-explore给出三种结构上真正不同的方案;craft-critique检查层级、间距、对比度、文案、一致性和动效;craft-system审计 token 与组件;craft-sync把代码中的设计系统同步到设计工具,之后再把指南变更以 diff 形式写回代码。
描述得很精确的小改动会直接执行,不经过完整流程。
使用约束
- 项目依赖外部 Agent 运行时和 skills CLI;技能本质是提示词指令,不是独立的桌面设计工具。
DESIGN.md是所有技能共享的事实来源,每个技能都会先读取它,因此首次运行craft-setup实际上是一致产出的前提。- 按 README 说明,Figma 适配器尚未测试;Paper(MCP)或纯 HTML 是更可靠的路径。
- 开发时用
npm test和npm run check校验技能格式与链接;每个技能都按测试先行编写,场景文件在tests/scenarios/。 - 仓库采用 MIT 许可证 (L139-L141)。
HotRepo 点评
craft 出现在 HotRepo 2026 年 11 月 17 日 JavaScript 新项目快照中,记录到 104 个 Star,增长窗口内新增 3 个 Star。该项目没有 GitHub 日榜名次记录,也没有 Hacker News 讨论,现有数据只能说明这段早期增长,不足以判断趋势。技术上的看点是它把技能设计成流程约束——覆盖状态、在关键处停下等待确认、颜色全部 token 化、统一图标集——而不是风格提示词,这正是它与一般「让界面变好看」的提示词集合的区别。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- LemonFace0309/charles-skills一组供编程 Agent 使用的技能,用于审查与打磨 UI 设计、动效、截图和 Mac 存储。
- miqdadbadjuber/anti-slop过滤 AI 编程代理输出的通用 UI、空话文案和 AI 味代码,适合使用 AI 代理写代码的开发者。
- smokeeaasd/flawless-ui-ux为编程 Agent 提供 UI/UX 设计规范与检查 CLI,用于创建、重设计、精修和审查界面。
- southleft/figma-console-mcp把 Figma 设计文件接入 AI 助手的 MCP 服务器,可提取设计系统、创建界面和调试。
- addyosmani/agent-skills把资深工程师的规范、测试、评审与发布流程写成 Markdown 技能,让 AI 编程助手按步骤执行。