kill-ai-slop

消除 AI 垃圾设计

AI 垃圾设计有一种难看的独特方式：它堆砌所有可能的风格和细节，却始终没有明确重点。渐变、光晕、吉祥物、表情符号、一整面发光卡片，同时开启所有默认效果，直到每个产品都像同一套俗艳模板。缩略图里看起来很「有设计感」，可只要有人仔细一看就原形毕露。你的任务是删繁就简，让成品变成一个人真正会选择的样子。

每次修改都要遵循以下原则：

1. 先做决定，再做装饰。 每个视觉选择都必须说得出理由。
2. 一种强调色，一种风格。
3. 通过尺寸和留白建立层级。 给文字上色或更换字体是捷径。
4. 先做减法。 消除丑陋的第一步就是删掉东西。
5. 文案中，具体胜过煽动性。
6. 装饰必须有意义——图标、徽章、提示框都应传递信息。

工作流程

按顺序执行以下步骤。在用户看到报告之前，不要批量修改。

1. 确定范围

确认要扫描哪些内容。默认扫描应用／网站源码（跳过 node_modules、 dist、build、.git、vendor、锁文件、压缩文件）。如果项目混有多个应用，请询问用户。

2. 扫描

运行随附的扫描器，它会搜索代码库中每种迹象对应的代码级信号，并按组输出 file:line 命中结果：

node scripts/scan.mjs <root>          # human-readable report
node scripts/scan.mjs <root> --json   # machine-readable, for triage

扫描器使用纯 Node（无依赖项），且不会修改文件。将其输出作为初步索引，而非绝对依据——逐一阅读代码，确认每个命中结果。

缩小扫描范围：使用 --only=01,06 / --skip=19 按迹象 ID 筛选；使用 --exclude=legacy 排除路径（按项目相对路径中的子串匹配）。 --rules=extra.mjs 会加载其他项目或语言专用的迹象规则（随附的俄语文案示例 已随附俄语文案示例 scripts/rules.ru.mjs 是一个示例，也是你编写自定义规则的模板）。用户确认是有意为之的命中结果，可以在源码中用 deslop-ignore、deslop-ignore-next-line 06 或 deslop-ignore-file 注释固定——优先使用指定 ID 的形式，这样仍能发现新的迹象。

3. 分类

对每个命中结果，打开文件并判断是垃圾设计还是有意为之。这一步让此技能区别于 lint 规则。渐变、衬线字体或表情符号都可能是经过认真考量的选择。保留用户明确选定的内容（品牌令牌、徽标、有意设计的插画）。只标记默认效果。

阅读 references/taxonomy.md，了解每种迹象是什么，以及它为什么会给人机器生成的感觉；阅读 references/detection.md，了解确切的匹配模式及其常见误报。

4. 报告

在做任何修改之前，向用户提供分组摘要：列出每种迹象、你确认的 file:line 命中结果、一句话说明原因，以及建议的修复方案。格式如下：

slop  src/Hero.tsx:12   indigo→violet gradient        → one solid accent
slop  src/Hero.tsx:31   gradient-clip headline        → solid ink, scale up
slop  src/Note.tsx:8    border-l-4 callout ×3         → 1 aside, rest is body
slop  copy.md:1         "not just X — it's Y"         → say the specific thing
→ 4 groups, 11 hits.

然后询问用户要应用哪些分组，或是否全部继续处理。

5. 修复

以最小改动消除迹象，同时保留原有意图和功能。每种迹象的修改前→修改后模式请参阅 references/fixes.md。

• 优先修改共享令牌／组件，而不是逐个改动每个调用处。
• 绝不要擅自创造品牌色彩；如果必须调整调色板，请提出中性色加上项目现有强调色的方案，并让用户确认。
• 保留文案含义；让文案更具体，而不是直接删掉。
• 修复后重新运行扫描器，确认命中数量减少，并注明有意保留的命中结果及原因。

注意事项

• 尊重作者。 将不熟悉的文件和刻意设计的点缀视为他人的选择。如果不确定某项是否属于垃圾设计，请先询问，不要擅自删掉。
• 改动小且便于审查。 绝不重新格式化无关代码。绝不运行 git add -A；只暂存明确指定的文件，并保留他人尚在进行中的工作。
• 不为此工作添加新依赖。
• 尽可能进行视觉验证。 如果存在开发服务器，请查看修改前后的效果；扫描通过不代表页面就变得更好。

参考资料

• references/taxonomy.md — 35 种特征：各自是什么、为什么属于低质量内容，以及修复方法。
• references/detection.md — 具体的 ripgrep/正则表达式模式及误报情况。
• references/fixes.md — 修复前→修复后的示例模式。
• scripts/scan.mjs — 无依赖扫描器。