Impeccable không phải ArtCraft và không thuộc các sản phẩm hay bộ sản phẩm ArtCraft; đây là hướng dẫn độc lập, còn thông tin chính thức nằm ở impeccable.style và github.com/pbakaus/impeccable.
Impeccable: từ vựng thiết kế cho tác nhân lập trình của bạn
Impeccable là một skill thiết kế và công cụ dòng lệnh mã nguồn mở, cung cấp cho tác nhân lập trình một từ vựng chung để đánh giá, chỉnh sửa và hoàn thiện giao diện. Paul Bakaus tạo ra nó, bắt đầu từ skill frontend-design của Anthropic, và phát hành theo giấy phép Apache-2.0. Trang này là hướng dẫn độc lập, không phải tài liệu chính thức.
- 24 lệnh: critique, polish, audit, typeset, distill và nhiều lệnh khác
- Bộ phát hiện với 62 quy tắc tất định, không cần LLM hay API key
- Hỗ trợ Claude Code, Cursor, Codex CLI, Copilot và tổng cộng 19 tác nhân
Trang chính thứcKho GitHubTài liệu
Cập nhật lần cuối: · English
Impeccable là gì
Impeccable là một skill cài vào tác nhân lập trình, đem lại cho nó từ vựng thiết kế, cùng một CLI chạy độc lập. Nó không mở khung vẽ mà biến thiết kế thành các lệnh tác nhân thực thi được: phê bình, cô đọng, chỉnh chữ, dọn dẹp và gia cố. Dự án khởi đầu từ skill frontend-design của Anthropic và được phát hành theo Apache-2.0.
Mục tiêu là gu mặc định của tác nhân: Inter ở khắp nơi, gradient tím sang xanh, thẻ lồng trong thẻ, chữ xám trên nền màu, ô biểu tượng bo góc trên mỗi tiêu đề. 62 quy tắc tất định đánh dấu những dấu hiệu này ngay khi chỉnh sửa, không dùng LLM và không cần API key.
Nó mạnh nhất với giao diện đã tồn tại: trỏ vào một trang hoặc một thành phần rồi lặp lại. Nó cũng dựng được trang mới, nhưng chính dự án thừa nhận chế độ đó khó hơn. Cần nói rõ: Impeccable là dự án mã nguồn mở độc lập, không phải sản phẩm ArtCraft và không thuộc bộ sản phẩm của ArtCraft.
Cài đặt và khởi tạo
Chạy lệnh từ thư mục gốc của dự án. npx cần Node 18.19 trở lên. Trình cài đặt sẽ nhận diện công cụ lập trình của bạn, hỏi cài cho dự án hay toàn cục, và đề nghị design hook ở nơi công cụ hỗ trợ. Nên chấp nhận hook này.
Sau đó tải lại công cụ rồi chạy /impeccable init ($impeccable init trên Codex). Với script, có thể truyền --providers=claude,codex,cursor và --scope=project|global. Bản cài đã có được làm mới bằng npx impeccable update.
npx impeccable install- Kiểm tra Node 18.19+ và mở thư mục gốc dự án.
- Chạy npx impeccable install, chọn phạm vi dự án hoặc toàn cục, và bật design hook nếu được hỗ trợ.
- Tải lại công cụ lập trình, rồi chạy /impeccable init ($impeccable init trên Codex) để tạo PRODUCT.md.
- Nếu muốn cố định hệ thống thị giác, chạy /impeccable document để tạo DESIGN.md; sau đó duy trì bằng npx impeccable update.
Các lệnh cốt lõi
Có tất cả 24 lệnh. Cách dùng là «lệnh + mục tiêu», ví dụ /impeccable critique the pricing cards; trên Codex thay dấu gạch chéo bằng $. Gõ riêng /impeccable sẽ hiện danh sách. Dưới đây là bảy lệnh hữu ích nhất.
| Lệnh | Chức năng | Khi nào dùng |
|---|---|---|
/impeccable init | Đọc mã nguồn, chỉ hỏi điều không thể suy ra rồi ghi PRODUCT.md. | Một lần khi bắt đầu dự án, để tạo ngữ cảnh cho các lệnh sau. |
/impeccable critique | Đưa ra đánh giá UX có chấm điểm theo nguyên tắc khả dụng và xếp thứ tự việc cần sửa trước. | Trước khi thiết kế lại, hoặc để tìm chỗ tắc trong một luồng. |
/impeccable polish | Thực hiện lượt chỉnh cuối trước khi phát hành. | Khi tính năng đã chốt và sắp lên bản. |
/impeccable audit | Lập báo cáo kỹ thuật về khả năng tiếp cận, hiệu năng, giao diện màu, khả năng đáp ứng và tính toàn vẹn triển khai, với phát hiện từ P0 đến P3. | Trước khi phát hành hoặc để xử lý nợ kỹ thuật. |
/impeccable typeset | Sửa phông chữ, phân cấp, cỡ chữ và khoảng cách. | Khi chữ nghĩa lỏng lẻo hoặc phân cấp không rõ. |
/impeccable distill | Loại bỏ những gì trang không cần. | Khi nội dung quá dày và trọng tâm bị loãng. |
/impeccable hooks status|on|off | Xem, bật hoặc tắt design hook; hook quét các tệp giao diện khi tác nhân chỉnh sửa. | Để kiểm tra việc tự động kiểm soát có chạy không, hoặc tạm dừng nó. |
Quy trình làm việc đề xuất
Ngữ cảnh trước, màn hình sau. init chỉ hỏi điều không thể suy ra: sản phẩm dành cho ai, cần đạt được gì và có ràng buộc nào. Câu trả lời được ghi vào PRODUCT.md và mọi lệnh sau đều đọc tệp này. Nếu đã có hệ thống thị giác, hãy chạy document để ghi quy tắc thương hiệu vào DESIGN.md, tránh việc tác nhân đổi phong cách giữa chừng.
Mục tiêu càng hẹp, kết quả càng tốt. Thay vì «làm lại cả trang», hãy thử «critique các thẻ giá». Những lệnh dùng thường xuyên có thể ghim bằng /impeccable pin audit để thành phím tắt /audit; trước khi phát hành, kết thúc bằng audit rồi polish.
- Chạy /impeccable init một lần cho mỗi dự án và xem lại PRODUCT.md vừa tạo.
- Nếu đã có design system, chạy /impeccable document và tóm tắt phông chữ, màu sắc, thành phần vào DESIGN.md.
- Lặp theo từng phần: /impeccable critique the pricing cards, rồi dùng bolder, quieter, distill hoặc typeset để chỉnh hướng.
- Trước khi công bố, chạy /impeccable audit rồi /impeccable polish, và ghim những lệnh quen dùng bằng pin.
Các tác nhân được hỗ trợ
Danh sách chính thức khá rộng: Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness và Veto. Cách cài khác nhau theo từng công cụ; danh sách đầy đủ có trong tài liệu chính thức.
Claude Code, Copilot và Grok có plugin; design hook hỗ trợ Claude Code, Cursor, Codex, GitHub Copilot, Grok Build và Hermes Agent. Với Codex, cần duyệt hook của dự án trong /hooks; Grok Build cần /hooks-trust; Hermes cần bật plugin.
Không muốn cài Node thì có thể sao chép thư mục skill thủ công. Nếu chỉ dùng bộ phát hiện, npx impeccable detect chạy mà không cần tác nhân. Chế độ live hỗ trợ Vite, Next, SvelteKit, Astro, Nuxt và HTML thuần, nhưng chỉ sửa bản sao cục bộ.
Impeccable và ArtCraft MCP
Hai cái tên na ná nhau vì đều giúp tác nhân tạo ra sản phẩm, nhưng chúng ở hai tầng khác nhau. Impeccable làm việc trên mã nguồn giao diện; ArtCraft MCP là MCP/CLI chính thức theo từng ứng dụng của storytold, điều khiển các Crafting Apps cục bộ như PhotoCraft. Nó cũng không phải API thuê bao cùng tên artcraft-mcp của cộng đồng.
| Khía cạnh | Impeccable | ArtCraft MCP |
|---|---|---|
| Tác động lên | Mã nguồn frontend trong kho: thành phần, JSX/TSX, CSS và cấu trúc trang. | Crafting Apps cục bộ (ví dụ PhotoCraft) cùng quy trình hình ảnh, video của chúng. |
| Tạo ra | Gợi ý thiết kế, sửa mã, báo cáo critique/audit, cùng PRODUCT.md và DESIGN.md. | Hình ảnh hoặc video, và các thao tác tự động trong những ứng dụng đó. |
| Khi nào chọn | Khi cần dựng, đánh giá hoặc hoàn thiện giao diện frontend. | Khi cần tạo hoặc xử lý hình ảnh, video hàng loạt và tự động hóa công việc trong ứng dụng. |
| Dùng chung được không | Có: giao diện dùng Impeccable, sản xuất tư liệu dùng ArtCraft MCP. | Có, nhưng chỉ cho tư liệu media: nó không đánh giá thiết kế giao diện và không thay thế Impeccable. |
Hướng dẫn ArtCraft MCPCrafting Apps
Giới hạn và an toàn
Impeccable là skill thiết kế frontend và CLI, không phải ứng dụng thiết kế hay công cụ tạo ảnh. Chế độ live chỉ sửa bản sao cục bộ; đừng chèn nó vào trang đã triển khai và đừng nới lỏng CSP production để nó chạy.
Hook chạy ngoài cơ chế phê duyệt của mô hình. Trong Claude Code, hook lệnh đã cài có thể vẫn thực thi dù bạn từ chối lệnh của mô hình, và lần chỉnh sửa đầu tiên có thể tải engine về. Hãy xem lại hook trước khi chạy không giám sát, hoặc tắt bằng --settings '{"disableAllHooks": true}'.
Telemetry ghi ẩn danh những hướng thị giác được hiển thị và hướng nào được chọn; tên dự án, tệp, mã nguồn và PRODUCT.md không bị gửi đi. Có thể tắt bằng npx impeccable telemetry off, DO_NOT_TRACK=1 hoặc "telemetry": false trong .impeccable/config.json. Với bộ phát hiện, mã thoát 2 nghĩa là có phát hiện, 1 là không quét được mục tiêu.
Hướng dẫn liên quan
Câu hỏi thường gặp
Impeccable là gì, và có phải sản phẩm của ArtCraft không?
Impeccable là skill thiết kế và CLI cho tác nhân lập trình do Paul Bakaus tạo, gồm 24 lệnh và bộ phát hiện 62 quy tắc theo giấy phép Apache-2.0. Đây không phải sản phẩm ArtCraft và không thuộc bộ sản phẩm của ArtCraft. Trang này là hướng dẫn độc lập; nguồn chính thức là impeccable.style và github.com/pbakaus/impeccable.
Cài đặt thế nào?
Từ thư mục gốc dự án, chạy npx impeccable install rồi tải lại công cụ lập trình. Sau đó chạy /impeccable init, hoặc $impeccable init trên Codex, để tạo PRODUCT.md. npx cần Node 18.19 trở lên, và npx impeccable update làm mới bản cài sẵn có; các bước đầy đủ ở impeccable.style/docs.
critique và audit khác nhau thế nào?
critique là đánh giá UX có chấm điểm dựa trên nguyên tắc khả dụng, cho biết nên sửa gì trước. audit là báo cáo kỹ thuật về khả năng tiếp cận, hiệu năng, giao diện màu, khả năng đáp ứng và tính toàn vẹn triển khai, với phát hiện xếp từ P0 đến P3. Một bên đánh giá trải nghiệm, bên kia kiểm tra kỹ thuật, và thường được dùng nối tiếp.
Có cần API key không?
Bộ phát hiện thì không: 62 quy tắc đều tất định, không gọi LLM và không đọc khóa. Bản thân skill chạy trong tác nhân của bạn nên cũng không cần khóa mô hình riêng. Có thể tắt telemetry bằng npx impeccable telemetry off hoặc DO_NOT_TRACK=1.
Nó hoạt động với những tác nhân nào?
Với Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness và Veto. Cách cài và mức hỗ trợ hook khác nhau theo công cụ; danh sách cập nhật ở impeccable.style/docs.
Nên chọn Impeccable hay ArtCraft MCP?
Tùy vào thứ bạn muốn thay đổi. Impeccable làm việc trên mã giao diện và trả về gợi ý, chỉnh sửa cùng đánh giá. ArtCraft MCP điều khiển các ứng dụng cục bộ như PhotoCraft để tạo hình ảnh, video và tự động hóa quy trình. Hai bên có thể dùng cùng nhau, nhưng ArtCraft MCP không phải công cụ đánh giá thiết kế và không thay thế Impeccable.
Tuyên bố độc lập
Impeccable là dự án mã nguồn mở độc lập do Paul Bakaus tạo ra. Nó không liên kết với ArtCraft, không phải sản phẩm ArtCraft và không thuộc bộ sản phẩm hay các thành phần chính thức của ArtCraft. Trang này do bên thứ ba viết cho độc giả Việt Nam; về lệnh, yêu cầu và tin mới, hãy lấy trang chính thức impeccable.style và kho github.com/pbakaus/impeccable làm chuẩn. ArtCraft MCP là một tích hợp chính thức khác, tập trung vào Crafting Apps và giải quyết bài toán khác.
Sources
Every fact on this page comes from the pages below, checked on 3 November 2026.