do-design 是做什么的?
路径相对于本技能文件夹;P 表示项目根目录。脚本为标准库 Python 3.8+。在推理脚本测量的任何内容之前先运行脚本,引用其输出,切勿重新推导或估计其报告的内容。
模型
- 项目的
DESIGN.md(纸面设计)具有约束力,优先于本技能。冲突时纸面设计获胜;请明确说明。 - 每条规则都附带其理由。 没有理由的规则在第一次遇到不便时即被删除。
- 证据优先于默认值。 一份简单的简报(“让它焕然一新”+ logo)是研究的原因,而不是退回到惯用外观或捏造事实的理由。没有来源,就没有主张:标记缺口或提问。
- 惰性加载。 只加载命令表命名的文件。额外的“为了完整性”的层次是方法上的失败。
- 惯例是默认值,不是失败。 模式决定了偏离的程度。
模式:在每个命令开始时声明一行
| 模式 | 访客处于 | 推动力度 |
|---|---|---|
| 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.md | WCAG 对比度比率 |
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 suggest | profile |
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 导入:归档文件夹通常包含活跃部分。切勿为了通过检查而编造纸面设计。
不可协商事项
- 切勿破坏工作代码。 Props、状态、路由、处理程序和无障碍性必须保留;文案保持其含义。
- 简报获胜。 陈述的品牌、字体或颜色优先于品味,即使在拒绝列表上也是如此。将其写入纸面设计(令牌块中的
allow:有意关闭某项检查器规则或审计 ID)。 - 切勿捏造事实、素材或来源。 删除模糊声明;切勿用捏造的细节替换它。使用缺口标记。
- 保留作者的语态。 消除机器习惯,保留人的特质。
- 密度,而非存在。 基于集群行动(3 个以上不同的 P0/P1 指示),绝不基于一个渐变或一个 em 破折号。干净的结果是有效的;切勿制造发现。
- 修复,切勿指责。 绝不说“这看起来像 AI 生成的”;指出未做出选择的部分以及如何替代。
- 除非被要求,否则只读用于评审和审计。