YesPlayMusic插件开发专家:构建企业级扩展
1753 行文本,零依赖:unslop 把界面去 AI 味变成一套有顺序的流程
整个仓库 20 个文件、1753 行文本、3.3 MB,没有构建脚本,也没有依赖。unslop 只交付一份写给 Claude 的操作说明,把 AI 味屏幕修成有自己设计的界面。这么小的一份说明,值得开发者读吗?
交付物盘点:7 个文件,全是规则和数值
这个仓库的全部交付物装得进 7 个文件,读完一遍就能判断它有没有用。
| 路径 | 规模 | 作用 |
|---|---|---|
| skills/unslop/SKILL.md | 233 行 | 主流程:审计、五行方向、9 轮 pass 顺序、结尾 checklist |
| skills/unslop/references/signs.md | 103 行 | 64 条"病症 → 修法",按 10 个症状组分类 |
| skills/unslop/references/tokens.md | 135 行 | 13 级间距刻度、3 套中性色阶、字号、圆角、动效曲线的具体数值 |
| skills/unslop/references/visuals.md | 84 行 | 图像生成 prompt 配方与上页摆位方法 |
| skills/unslop/references/effects.md | 113 行 | 字符马赛克、半调、抖动、双色调的代码实现 |
| skills/unslop/scripts/snapshot.mjs | 144 行 | 把链接页面抓成自包含 HTML |
| skills/unslop/scripts/story.mjs | 461 行 | 渲染"屏幕被逐步修好"的方形视频 |
根目录的 README、LICENSE、CITATION.cff 只是安装说明、CC BY 4.0 许可全文和引用格式。验收标准写在 SKILL.md 开头:
Removing slop is only half the job. A screen that is clean but could belong to any product is the next template.
大白话:把 AI 味洗掉只是上半场,修完的屏幕如果换个产品名也能用,那就掉进了下一个模板。这句话能传播,是因为它点出了美化最常见的二次失败,而 signs.md 末尾真设了一个独立的"模板感"组专门接住它。
下半场全是数字:间距刻度是 4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 96, 128,整屏统一一条动效曲线 cubic-bezier(0.22, 1, 0.36, 1),圆角表从 keycap 的 4 到 6 排到 panel 的 14 到 20。全文找不到"好看"或"协调"这类词。
核心机制:四步有依赖链,顺序不许换
9 轮 pass 不是并列的建议清单,而是一条依赖链:前一步错了,后面的步全部白做。
第一步,先看见。 改代码前先对屏幕截图,判断依据是人看到的东西,不只是代码。只有链接时,用 snapshot.mjs 抓一份自包含 HTML:样式内联,url() 里的资源转成 data URL,单文件 3 MB 封顶,再另存一张 live 截图供前后比对。跳过这步,审计就变成对着文件名的猜测。
第二步,列出证据。 对照 skills/unslop/references/signs.md 逐条走 64 项,每条写清位置:导航图标是不是 🚀 式 emoji,间距是不是 mt-[13px] 这种随手值,标题是不是紫到蓝的渐变文字。审计排第一的原因有二:没有证据,"修"就是凭感觉;审计清单同时是验收清单,结束时重新渲染逐条对照,还在清单上的必须修掉。
第三步,写五行,然后停。 产品是什么、性格是哪两三个词、属于什么材质与世界、哪一两处允许承载颜色、一个只有本产品才有的签名细节。clean、modern、sleek、minimal、premium 五个词被禁用,理由一句话:它们描述的是所有模板。方向写完给用户看,等确认再动手,因为方向改了等于全部重做。
第四步,按序修。 间距 → 颜色 → 图标 → 文案 → 字体 → 布局 → 细节 → 视觉 → 动效,每轮覆盖整屏再进下一轮。理由在 skills/unslop/SKILL.md 里写明:间距排第一,其他规则都立在节奏之上;文案先于字体和布局,标题定稿了字号和位置才跟着定;视觉和动效垫底,装饰要跟随一个已经立住的屏幕,而不是相反。以间距轮为例,照做的方法是两件事:所有值落到 4px 网格上,28 和 104 是 4 的倍数所以合格,mt-[13px]、py-[11px] 必须换刻度值;"同一件事同一个尺寸",列表所有行同高同间隙。AI 生成屏幕的病,往往不是单个数值难看,而是两个相同的按钮用了不同的内边距。
流程还有硬预算:一次运行渲染检查至多 3 次。整个过程可以录成 10 秒方形视频,story.mjs 从 story 页两个 <meta> 读步骤名与取景框,页面按 1440 宽渲染,画布 1080×1080,--wide 时 1920×1080;每步只叠一层新 CSS,所以间距、颜色、圆角都能在原地补间,文字替换每支故事上限 8 处。
最锋利的一条:换个产品名,界面还成立吗
全文最容易被转发的不是任何数值规则,而是 checklist 的最后一问:
Template check. If you swapped the product name for another product's, would the screen still fit?
它有三个特征:是是非题,30 秒能自测,没有解释空间,不需要争论审美。规范告诉你什么好看,这一问告诉你什么还不够。一块干净的屏幕如果换个 logo 就能卖别的产品,它只是从紫色模板换成了石墨模板。
仓库里的成品自己回答了这一问。这块开票产品的 hero 用数字和货币符号当材料画出一架纸飞机,便签钉在机身上——材料就是产品经手的钱,换成任何别家公司,画面当场失效。
同类机器可执行的规则还有 skills/unslop/references/tokens.md 里的嵌套圆角:
Nested radius: inner = outer − padding, never below 4.
16px 的卡片配 8px 内边距,里面元素的圆角就是 8。一条公式,机器照抄,人一眼看出对错——这类规则才配进 skill,而不是靠人凭印象翻文档。
它不解决什么:三个边界与一类不适用人群
文档把自己写得很清楚,边界部分比功能列表更可信。
- 它看不见你的屏幕,除非你给它看。 只有链接就得先走 snapshot.mjs 存档,脚本自己也承认:脚本绘制的动态背景不会留在快照里,只能在审计里凭线上页面口述。
- 图像生成要花钱,所以必须停下来问。 visuals.md 要求先展示 prompt、模型、尺寸,用户点头才运行;没有图像工具时留一个尺寸和圆角都对的空槽位,prompt 写进报告——避免模型为了完成任务塞一张风格不搭的占位图。
- 许可是 CC BY 4.0,不是代码许可证。 商用、修改、再分发都可以,但要署名 Damir Sokolovsky 并链回原仓库;story.mjs 渲染出的每段视频也自带一行 unslop by @heydamir。想把脚本抽出来当依赖复用,需要自己划合规线。
不建议用的人:屏幕已有真实品牌体系、本来就没问题,或者你要修的是散文而不是界面。它的 9 轮里没有一轮处理文字指纹;仓库里 runs/deterministic-vs-llm/ 是作者单独做的文本侧实验,其中 regex_pass.py 只有 65 行,纯规则、无模型无网络,说明作者把两条路当成两件事。
最短上手路径:clone 之后 3 步跑通
- 拿代码:
git clone https://gitcode.com/gh_mirrors/unsl/unslop,把 skills/unslop/ 整个复制进 Claude Code 的 skills 目录(全局在 ~/.claude/skills/,单项目放在项目内 .claude/skills/)。 - 在 Claude Code 里输入
/unslop this dashboard,或者直接用一句"帮我把这个界面修得别像 AI 做的",技能会被自动拾取;它会先出审计和五行方向,等你确认才动文件。 - 只有链接就先跑
node skills/unslop/scripts/snapshot.mjs <url> unslop/original.html拿到本地副本;想发前后对比,装好 Playwright 和 ffmpeg,再用 skills/unslop/scripts/story.mjs 渲染 10 秒方形视频。
unslop 交付的是一套逼你做决定的流程:审计要证据,方向要署名确认,9 轮顺序不许换。数值可以抄,五行方向只有产品自己写得出来,该不该动手它也替你想过。
先判断,再动手。
更多推荐



所有评论(0)