Ưu, nhược và chỗ chưa rõ
| Ưu | README ghi rằng hook dò lỗi quét mọi file UI agent vừa sửa và trả kết quả trước khi agent báo xong. Bộ dò này cũng chạy được trong CI bằng npx impeccable detect, không cần agent. | README, Three ways to run the detector |
|---|---|---|
| Ưu | Lần chạy của mình (rà lỗi một trang mẫu, chỉ đọc mã): bản có skill tìm ra 3 lỗi đúng mà bản không skill bỏ sót, gồm lệnh cài bị cắt bằng dấu …, thiếu color-scheme và thiếu màu dự phòng cho nhóm. | Lần chạy của mình, 2026-10-29 |
| Nhược | Lần chạy của mình: bản không skill có 27 lỗi đúng, bản có skill có 19 lỗi đúng và 1 lỗi sai; bản có skill tốn hơn 13% (0,77 USD so với 0,68 USD). Lần đó engine và trình duyệt của skill không chạy vì phiên không có Bash. | Lần chạy của mình, 2026-10-29 |
| Nhược | README ghi rằng trong Claude Code, hook đã cài vẫn chạy kể cả khi bạn từ chối lệnh của model, nên lần sửa file đầu tiên có thể tải engine về máy. Muốn tắt cho một lần chạy phải thêm --settings '{"disableAllHooks": true}'. | README, Good to know |
| Nhược | Telemetry bật sẵn. Khi tắt telemetry, skill vẫn gửi yêu cầu lấy hướng thiết kế tới impeccable.style; chỉ phần ghi lại lựa chọn của bạn là dừng. | README, Telemetry |
| Nhược | Từ 2026-09-25 đến 2026-10-15, lệnh npx impeccable install báo HTTP 404 và không cài được gì, vì đường tải trỏ tới một bản phát hành chưa có. Tác giả đã sửa và đóng issue. | Issue #857 |
| Nhược | Bộ quét tĩnh đọc cả CSS trong khối @media in ấn và chế độ tối, nên báo sai lỗi tương phản thấp. Issue còn mở; tác giả đã chốt cách sửa ngày 2026-10-15. | Issue #988 |
| Chưa rõ | Mình chưa chạy engine, hook và live mode, vì chúng cần Bash và tải file chạy về máy. Kết quả của mình chỉ nói về phần hướng dẫn bằng chữ. | Lần chạy của mình, mục Open issues |
| Chưa rõ | Trong bài phỏng vấn trên Latent Space, tác giả nói Impeccable không dùng để thiết kế xong trong một lượt; bạn sửa dần bằng các lệnh như bolder, quieter. Chưa có bài đo độc lập nào so số lượt sửa cần có. | Latent Space, 2026-07-02 |
Khi nên dùng
- Bạn muốn agent tự quét lỗi giao diện sau mỗi lần sửa file UI, hoặc muốn chạy bộ dò lỗi trong CI.
Khi không nên dùng
- Bạn không muốn hook tự chạy và tự tải file về máy, hoặc dự án không được gửi bất kỳ yêu cầu nào ra ngoài.
Cách cài
Claude Code
npx [email protected] installCodex CLI
npx [email protected] installNó chạm vào những gì
- File đọc và ghi
- Trình cài ghi hook vào .claude/settings.local.json của dự án (hoặc ~/.claude/settings.json nếu cài cho cả máy), và file hook cho Codex, Cursor, Copilot, Gemini trong dự án. Skill ghi file làm việc vào thư mục .impeccable/ của dự án.
- Gọi mạng
- Lần đầu chạy, script tải một file chạy (engine) từ github.com/pbakaus/impeccable/releases về ~/.impeccable/bin/, có kiểm tra mã SHA-256. Khi bắt đầu một thiết kế mới, engine gửi một yêu cầu GET tới impeccable.style/api/roll; telemetry bật sẵn và gửi lựa chọn của bạn tới impeccable.style/api.
- Script lúc cài
- Hook SessionStart, PostToolUse (Edit|Write) và Stop đều chạy scripts/impeccable hook; Stop có thời gian chờ 30 giây.
- Tiến trình
- Mỗi lần agent sửa file, hook bật engine để quét. Live mode bật một server cục bộ và mở trang dev của bạn trong trình duyệt.
Đọc từ: hooks.json, impeccable#L111-L173, telemetry.rs#L44, concept_seed.rs#L156-L161, hooks.md#L17
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin