dym-impeccable-detect-cli-scan

Skill: dym-impeccable-detect-cli-scan — Quét anti-pattern bằng CLI

Vì sao dùng: chấm chất lượng design của code frontend một cách tất định — 61 luật, không LLM, không API key, chạy được trong pre-commit hoặc CI. Sinh ra cái gì: danh sách finding ra stderr (hoặc JSON ra stdout với --json), cộng một mã thoát để tự động hoá rẽ nhánh.

---

Chạy nhanh

npx impeccable detect src/                    # quét thư mục
npx impeccable detect index.html              # quét một file HTML
npx impeccable detect https://example.com     # quét URL (render bằng Puppeteer)
npx impeccable detect --json .                # JSON cho máy đọc
npx impeccable detect --no-config src/        # quét thô, bỏ mọi config/waiver của dự án

Dạng rút gọn cũng chạy: npx impeccable src/. cli/bin/cli.js:23-30 coi một tham số là target khi nó bắt đầu bằng -, là URL, chứa //\/., hoặc là đường dẫn có thật; ngược lại nó bị coi là lệnh gõ sai:

npx impeccable frobnicate
# Unknown command: "frobnicate"
# rc = 1

Output thật trên một file bẩn:

probe/index.html
  [gray-on-color] text #808080 on bg gradient(#667eea, #764ba2)
    → Gray text looks washed out on colored backgrounds. ...
  [low-contrast] 1.1:1 (need 4.5:1) — text #808080 on #667eea
    → Text does not meet WCAG AA contrast requirements ...
  [overused-font] Primary font: inter
    → Inter, Roboto, Fraunces, Geist, Plus Jakarta Sans, and Space Grotesk are used on so many sites ...
  [skipped-heading] <h1> "Hi" followed by <h4> "Skipped heading" (missing h2)
  [ai-color-palette] Purple/violet accent colors detected

7 anti-patterns found.

Mã thoát — đọc kỹ, đừng giả định 0/1

Từ cli/engine/cli/main.mjs:492-495:

const exitCode = hadOperationalFailure ? 1 : (primary.length > 0 ? 2 : 0);

rc	Nghĩa
0	Quét xong, không có finding chính (advisory vẫn có thể được liệt kê)
1	Ít nhất một target không quét được — lỗi vận hành, ưu tiên hơn rc 2
2	Quét xong và có finding chính