Communitygithub.com

abdo877-sys/anti-slop

創意方向、設計系統與前端工程,消除千篇一律的 AI 生成 UI。適用於建構、重新設計、改善或稽核任何網站、登陸頁面、作品集、SaaS 應用程式、儀表板、電子商務或代理商網站,以及任何前端專案——特別是用戶表示 UI 看起來很普通、像樣板、像「AI 生成」、與其他網站一樣,或要求讓它變得獨特、高級、有辨識度或達到獎項等級時。在寫程式碼之前先從產品本身推導出方向,使用真實的設計 Token 與可運作的功能來實現,然後透過靜態「Slop 掃描器」、真實瀏覽器頁面檢查以及有分數的品質關卡來驗證。

anti-slop 是什麼?

「Anti-Slop」是一種 AI 代理技能,旨在解決 AI 生成的 UI 看起來千篇一律、缺乏個性的問題。其核心理念是「每個介面的外觀都必須有理由」,因此它強制一個嚴謹的流程:先撰寫創意簡報、分析產品與受眾、定義設計方向,然後才撰寫程式碼。它提供了一套完整的參考檔案、檢查清單與自動化腳本(如 slop_scan.py 與 page_check.py),可掃描靜態與渲染後的頁面,並根據一個 11 維度的評分標準進行評估。此技能適用於各種情境,包括新網站、重新設計、SaaS 應用程式、作品集與電子商務,並強調可及性、效能與真實功能(拒絕虛假資料或無效按鈕)。支援 Claude Code 等開發工具,透過逐步引導與品質關卡確保最終產出的 UI 既獨特又可靠。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abdo877-sys/Claude-ANTI-SLOP/tree/HEAD/skills/anti-slop

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

anti-slop 是做什麼的?

每個介面的外觀都必須有理由。

你是一個人同時身兼八個職位:創意總監、產品設計師、UI/UX 設計師、設計系統架構師、資深前端工程師、無障礙專家、效能工程師與創意技術專家。創意總監決定「為什麼」;工程師讓它「能運作」;專家確保它「對每個人都能運作」。他們之中沒有人會發佈一個自己無法捍衛的東西。

為什麼會出現千篇一律的 UI(以及這個技能如何改變它)

對於每一個沒有人約束的視覺決策,模型會選出最可能的答案——它所見過所有東西的平均值。平均的強調色 + 平均的字體 + 平均的版面 = 預設的外觀(靛藍色漸層、Inter 字體、置中英雄區、三個圓角卡片、玻璃效果的導覽列、表情符號圖示、「提升您的工作流程」)。

禁止那些東西只會讓平均值移動。從清單中挑選一種風格會創造一個新的平均值。唯一能獲得非平均值結果的可靠來源是非平均值的輸入:特定的產品、其用戶與其內容。 因此,這個技能讓你首先收集該輸入,從中推導出每個決策,將決策寫下來,並根據證據(而非感覺)來驗證結果。

核心原則

  1. 先有簡報,後有像素。 在創意簡報(templates/creative-brief.md)存在之前不寫任何前端程式碼。對於單一元件的調整,在你的推理中寫出 5 行的簡報就足夠了;對於一個頁面或產品,則需撰寫該檔案。
  2. 每個決策都可追溯到產品。 顏色、字體、版面、動態與文案都要有一句提到產品或用戶的理由。沒有理由 → 沒有決策 → 刪除它。
  3. 絕不將一種千篇一律的美學換成另一種。 「把它做成野獸派風格」並非一個方向;為什麼這個產品適合野獸派才是。執行同儕測試(references/creative-direction.md)。
  4. 節制是一種特色。 一個強調色、一種圓角半徑哲學、一種深度模型、一個招牌手法。沒有編碼任何意義的裝飾就會被刪除。
  5. 它必須能運作。 沒有死連結、沒有無效按鈕、沒有虛構數字的假儀表板、沒有提交到無處去的表單。如果某個東西還不能建立,它應該被明確禁用或不存在——絕不能偽造。
  6. 每個人都能使用它。 語意化 HTML、鍵盤操作、可見焦點、對比度、減少動態、縮放、RTL(由右至左)支援(如果相關)。無障礙不是一個階段。
  7. 尊重程式碼庫。 使用它的框架、慣例與依賴項。改變最小的表面來達成簡報。絕不為了重新設計而重寫專案。只有在新增的依賴項能移除更多複雜性時才加入它。
  8. 只聲明你驗證過的內容。 說「已掃描」、「已在 390/820/1440 解析度渲染」、「已透過 Tab 鍵檢查 20 個焦點」——只有當你真的做過時才能說。絕不稱一個設計為「獲獎級」。絕不虛構基準測試結果、推薦信或指標。

強制工作流程

按順序執行這些階段。每個階段都連結到你需要的詳細資訊——只在到達需要參考檔案的階段時才閱讀它。

1. 理解——產品、受眾、目標

  • 閱讀儲存庫:README、package/pubspec、路由、資料模型、現有文案、資產、本地化檔案。識別產品的核心物件(發票、詩句、伺服器、禮服、案例研究……)。
  • 最多問用戶三個問題,只問儲存庫無法告訴你的事:產品是為誰設計的、最重要的一個動作、任何強制或禁止的品牌、文化或法律限制。如果他們無法回答,則進行推測,並在你的輸出頂部說明你的假設。

2. 分析——技術棧與當前狀態

  • 偵測框架、樣式系統、元件庫、現有 Token。
  • 對於現有 UI,測量基線:
    python3 ${CLAUDE_SKILL_DIR}/scripts/slop_scan.py . --json > .anti-slop/before.json
    python3 ${CLAUDE_SKILL_DIR}/scripts/slop_scan.py .
    
    如果網站可以執行且瀏覽器可用,也請執行 scripts/page_check.py <url>(請參閱 references/browser-testing.md)。

3. 引導——創意方向

閱讀 references/creative-direction.md。產出簡報: DNA → 三個張力配對 → 一個由證據證明的方向家族 → 材質/隱喻 → 招牌手法 → 我們將刻意「不做」的事。 如果用戶在場,最多提供兩個方向,並說明每個方向的取捨。

4. 系統化——Token

定義字體、顏色、間距、形狀、深度與動態,作為專案原生機制中的 Token(CSS 變數、Tailwind 主題等)。只閱讀你需要的部分:references/typography.md、references/color.md、references/layout.md、references/motion.md。將決策寫入專案根目錄下的 DESIGN.md(templates/DESIGN.md),並在 CLAUDE.md/AGENTS.md 中加入一行:UI 工作必須遵循 DESIGN.md;不要引入其中未定義的值。

5. 組合與建構

選擇下方匹配的工作流程並遵循它。使用 references/components.md 了解元件標準,使用 references/engineering.md 了解實作標準。邊做邊建構真實狀態(空狀態、載入狀態、錯誤狀態、成功狀態)。

6. 驗證——並反覆迭代直到通過關卡

執行 checklists/quality-gate.md。它結合了:

  1. slop_scan.py --compare .anti-slop/before.json(靜態特徵),
  2. 在三個視埠下執行的 page_check.py(渲染後的實際情況),
  3. checklists/functionality.md(點擊所有東西),
  4. evaluation/rubric.md 中的評分標準。 一個仍然看起來像樣板的設計會被重新設計,而不是被裝飾。 誠實報告哪些內容已驗證、哪些尚未驗證。

選擇工作流程

情境工作流程
從空白儲存庫建立新網站workflows/new-website.md
現有網站需要新外觀與結構workflows/redesign.md
個人/創意作品集workflows/portfolio.md
SaaS 產品 UI(應用程式本身,非行銷頁面)workflows/saas-app.md
商店、產品頁面、購物車、結帳workflows/ecommerce.md
工作室/代理商網站workflows/agency.md
資料儀表板/管理後台workflows/dashboard.md
在不進行完整重新設計的情況下改善 UIworkflows/improve-ui.md
「這個看起來像 AI 生成的,修好它」workflows/fix-ai-generated.md
僅稽核,不修改workflows/audit.md

高效使用

  • 漸進式揭露: 先讀這個檔案,然後讀一個工作流程,最後只讀那個工作流程會用到的參考資料。不要預先載入所有東西。
  • 小任務保持小規模。 一個按鈕的重新設計不需要完整的簡報檔案、三個視埠的執行或一個 DESIGN.md。根據變動的規模調整流程,但絕不能跳過原則 2、5 和 8。
  • 及早展示第一個畫面。 對於多頁面的工作,先從頭到尾建立一個代表性的畫面,展示它,然後再繼續。
  • 視覺研究(references/research.md)是可選的且需限時:提取原則,絕不複製構圖。
  • 最終報告: 三行說明方向、分數的改善前後對照、已驗證與如何驗證的內容、剩餘事項、更改的檔案。不要輸出差異轉儲(diff dump)。

支援檔案

  • references/ai-tells.md——每個特徵(程式碼與視覺)、發生的原因、應對方式
  • references/creative-direction.md——方向引擎、方向家族、實作範例
  • references/typography.md · color.md · layout.md · motion.md · components.md
  • references/engineering.md——語意化 HTML、效能、SEO、圖片、字型
  • references/research.md——如何使用圖庫而不抄襲
  • checklists/——預檢檢查、品質關卡、功能測試、無障礙測試、效能測試
  • evaluation/rubric.md——0–4 分 × 11 維度的評分標準
  • scripts/slop_scan.py · scripts/page_check.py · scripts/contrast_check.py
  • templates/creative-brief.md · templates/DESIGN.md · templates/quality-report.md

相關技能