Communitygithub.com

do-design

UI 与视觉设计技能,以绑定的 DESIGN.md 为准则,并提供可度量的脚本。用于设计或重新设计页面和组件、审查 UI 变更、审计并评分 UI、重新设计网站、在开始设计前进行市场调研、推动大胆方向或在仓库中安装设计护栏。命令:do-audit, do-design-new, do-design-review, do-design-renew, do-crazy。

do-design 是什么?

do-design 是一个 AI 代理技能,专为 Claude Code、Cursor 等基于 AI 的编码工具设计,用于在开发工作流中强制执行一致、高质量的 UI/视觉设计。它将项目级别的 `DESIGN.md` 文件作为约束源(“纸面设计”),并提供一个包含可执行脚本和针对性的代理命令的框架,以审计、评分和生成 UI。该技能强调基于证据的决策(例如,通过脚本衡量设计,而不仅仅是视觉检查),并包括一个分级评分系统,从可操作的脚本输出中获取分数,而不是进行推测性推理。它支持多个命令:`do-audit` 进行全面评分,`do-design-review` 快速检查与纸面设计的一致性,`do-design-new` 和 `do-design-renew` 用于生成新的设计方向,以及高风险/高回报的 `do-crazy` 用于突破性创意。该技能提供了清晰的操作模式(Persuade、Operate、Read、Experience)和严格的规则,例如“切勿破坏工作代码”、“证据优先于默认值”以及“切勿捏造事实、素材或来源”。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diononline-un/design-skill/tree/HEAD

在你喜欢的 AI 中提问

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

文档

do-design 是做什么的?

路径相对于本技能文件夹;P 表示项目根目录。脚本为标准库 Python 3.8+。在推理脚本测量的任何内容之前先运行脚本,引用其输出,切勿重新推导或估计其报告的内容。

模型

  1. 项目的 DESIGN.md(纸面设计)具有约束力,优先于本技能。冲突时纸面设计获胜;请明确说明。
  2. 每条规则都附带其理由。 没有理由的规则在第一次遇到不便时即被删除。
  3. 证据优先于默认值。 一份简单的简报(“让它焕然一新”+ logo)是研究的原因,而不是退回到惯用外观或捏造事实的理由。没有来源,就没有主张:标记缺口或提问。
  4. 惰性加载。 只加载命令表命名的文件。额外的“为了完整性”的层次是方法上的失败。
  5. 惯例是默认值,不是失败。 模式决定了偏离的程度。

模式:在每个命令开始时声明一行

模式访客处于推动力度
Persuade(说服)决定并行动中强:模板即失败
Operate(操作)完成任务中克制:惯例即特性
Read(阅读)理解某事物中中等:阅读舒适度优先
Experience(体验)作品内部强:制品主导

根据表面而非产品选择:开发工具的目标页面是 Persuade,其设置屏幕是 Operate。

命令:加载一个命令文件,以及其行名指定的内容

命令使用场景额外加载风险
do-design-review“这与纸面设计相符吗?”最便宜,最常运行项目的 DESIGN.md-
do-audit“这有多好?”分数 + 排名发现references/critique-rubric.md, references/slop-catalog.md, 范围涉及的 layers 00-05-
do-design-new“构建 X”:传统、合格、符合纸面设计layers/00, 任务涉及的 1-3 层;如果简报单薄或面向客户,则加载 layers/06低
do-design-renew“重做此外观”:新世界,相同的产品本质layers/00, layers/06中等
do-crazy“做行业里没人会做的事”layers/00, layers/06高,有意为之

层次:00-craft-floor(所有模式)· 01-color· 02-typography· 03-space-layout· 04-motion-states· 05-voice· 06-research。编写纸面设计:templates/DESIGN.md, examples/01-two-papers.md,references/interview.md。

脚本(均接受 --json)

运行输出
scripts/check-design.py --root P与纸面设计令牌块的偏离。退出码 0 表示干净,1 表示偏离,2 表示无纸面设计/令牌。--init 从代码起草令牌
scripts/audit.py scan P源代码问题(ID 与 slop 目录一致),无障碍和浏览器表面缺口,价值清单
scripts/audit.py copy P散文和微文案问题,句子节奏,未填充的缺口标记
scripts/audit.py contrast FG BG / --paper P/DESIGN.mdWCAG 对比度比率
scripts/audit.py score H L S C T U D加权分数,等级,工作列表
scripts/render-audit.py URL-or-file [--shots DIR] [--inject-css FILE]在 1280/768/390 下绘制的页面:重叠、横向滚动、裁剪、绘制对比度、点击目标、焦点可见性。--inject-css 在部署前针对已部署页面测量 CSS 修复。需要 Chrome/Chromium
`scripts/research.py suggestprofile
bash scripts/install-guardrails.sh P从模板生成 DESIGN.md,包括 AGENTS.md/CLAUDE.md 块,检查器

截图消耗的上下文远多于脚本输出:仅在需要目视判断(层级、区分度、构图)时使用,且仅限视口,优先 390。脚本也可能出错:在报告看似不可能的 P0 之前,确认一次(针对性截图或元素几何信息),如果是误报则修复脚本。

共享定义

替换测试。 将产品名称替换为竞争对手的名称。如果没有任何问题,说明该页面没有表达该产品的任何信息:未做出选择,而非丑陋。通过文案、视觉和一个签名细节来修复,切勿通过添加装饰。

方向,五行。 在构建之前编写,展示,然后等待同意(如果被告知“直接做”,则用一行声明假设并继续):

Product:    它做什么,为谁做,一句话
Character:  2-3 个具体的词(绝不使用干净、现代、时尚、简约、高级)
World:      它所属的地方或材质;设定中性色调、强调色、意象
Moments:    1-2 个屏幕变得丰富的地方
Signature:  只有该产品才有的一个细节,一致使用

缺口标记。 在缺少事实或素材的地方使用 [number needed]、[source needed]、[photo needed]。audit.py copy 会列出仍处于开放状态的缺口;任何一个都不应发布。

评分:每个评估命令都以评分结束

#字段问题权重
1层级最重要的东西能否在 2 秒内被命名?3
2可读性对比度、字号、行长、每种宽度下的真实文案3
3体系一个调色板、一个比例尺、一个圆角逻辑、一种运动语言2
4工艺对齐、间距节奏、状态、浏览器表面2
5内容真实性真实数据、具体文案、无捏造声明3
6可用性任务可完成;功能暗示明显;错误可恢复3
7区分度是否通过替换测试?2

每项评分 0-4(4 = 真正优秀,而非“还行”),并使用 audit.py score 计算。等级:85+ 强,发布并仅修复 P0 · 70-84 健全,在修复指定的 P1 后发布 · 50-69 弱,先进行真正的完善 · <50 失败,方向错误:重建(do-design-renew)。 评分渲染效果,而非源代码。无法检查的字段标记为 u:得分为 0 并显示 unverified,绝不做估计。区分度仅在能说出是什么使得它成为该产品时才得 4 分。三个最差的字段是工作列表,每个字段一个操作。

严重性:P0 阻止发布(损坏、不可读、硬性禁止),全部报告 · P1 损害信任,最多 5 条 · P2 工艺,最多 5 条 · P3 润色,仅列出。 发现格式:[Pn] 位置 - 问题是什么 - 修复;脚本发现保留其 ID。

无纸面设计

说明“无 DESIGN.md:护栏无规则可执行。”提供编写选项(模板 + 访谈),或从代码改造(check-design.py --init + 访谈 §Retrofit):v1.0 即发布版本,旧值放入 legacy:(计数,不失败),缺口放入纸面设计的增量列表。归档和演示通过令牌块中的 skip:(或 --skip a,b)按文件夹或文件排除在所有扫描之外。排除前 grep 导入:归档文件夹通常包含活跃部分。切勿为了通过检查而编造纸面设计。

不可协商事项

  1. 切勿破坏工作代码。 Props、状态、路由、处理程序和无障碍性必须保留;文案保持其含义。
  2. 简报获胜。 陈述的品牌、字体或颜色优先于品味,即使在拒绝列表上也是如此。将其写入纸面设计(令牌块中的 allow: 有意关闭某项检查器规则或审计 ID)。
  3. 切勿捏造事实、素材或来源。 删除模糊声明;切勿用捏造的细节替换它。使用缺口标记。
  4. 保留作者的语态。 消除机器习惯,保留人的特质。
  5. 密度,而非存在。 基于集群行动(3 个以上不同的 P0/P1 指示),绝不基于一个渐变或一个 em 破折号。干净的结果是有效的;切勿制造发现。
  6. 修复,切勿指责。 绝不说“这看起来像 AI 生成的”;指出未做出选择的部分以及如何替代。
  7. 除非被要求,否则只读用于评审和审计。

相关技能