Dym Impeccable Chat Commands

Skill: dym-impeccable-chat-commands — 23 lệnh /impeccable (chỉ gõ trong CHAT)

Vì sao dùng: một bộ từ vựng design chung với agent — audit, critique, polish, harden... — thay vì mỗi lần lại mô tả lại từ đầu. Sinh ra cái gì: thay đổi code trong dự án, cộng các artifact dưới .impeccable/ (PRODUCT.md, DESIGN.md, surfaces/*.md, critique/*.md).

⚠️ Mọi thứ trong file này gõ trong khung chat của AI agent, KHÔNG phải terminal. CLI chặn cố ý:

$ npx impeccable init
"init" is not a CLI command. Type /impeccable init in your AI coding agent's chat ...   (rc 1)

Lệnh shell nằm ở 01–04. Đừng trộn hai loại.

Bắt đầu: /impeccable init (một lần cho mỗi dự án)

/impeccable init

init soi dự án, hỏi chỉ những khoảng trống thật sự về bối cảnh sản phẩm bền vững, rồi ghi PRODUCT.md (người dùng, mục đích, bối cảnh vận hành, ràng buộc, giọng điệu, bằng chứng). Nếu đã có code, nó đề nghị luôn DESIGN.md (màu, typography, component). Nó cũng cấu hình trước live mode và ghi buildPath vào .impeccable/config.json.

Mọi lệnh khác đọc hai file này trước khi làm việc. Bỏ init là mọi lệnh sau đó đoán mò bối cảnh.

buildPath có hai giá trị:

{ "buildPath": "comp" }

Ghi đè trên một máy bằng .impeccable/config.local.json (ví dụ harness của bạn không có image generation). Không cần chạy lại init để đổi: mỗi trang quyết định có toggle ở footer, lật là bind cho phiên đó.

23 lệnh

Đếm và mô tả lấy từ plugin/skills/impeccable/scripts/command-metadata.json, không phải từ bảng trong README.

Thiết lập & bối cảnh

Review & đánh giá

Sửa & hoàn thiện

Đổi hướng thẩm mỹ

Miền cụ thể

Chế độ đặc biệt

Cách gọi

Hầu hết lệnh nhận một tham số tuỳ chọn để khoanh vùng:

/impeccable audit blog            # audit trang hub + trang bài blog
/impeccable critique landing      # review UX trang landing
/impeccable polish settings       # pass cuối trước khi ship
/impeccable harden checkout       # error handling + edge case

Hoặc mô tả thẳng, không cần lệnh con:

/impeccable làm lại khối hero này

Gõ /impeccable một mình để agent liệt kê toàn bộ lệnh.

Codex dùng skill chứ không dùng /prompts: — mở /skills hoặc gõ $impeccable. Bản cài repo-local nằm ở .agents/skills/, bản user-wide ở ~/.agents/skills/. GitHub Copilot dùng .github/skills/. Skill mới cài mà chưa thấy thì khởi động lại tool.

Ghim lệnh hay dùng

/impeccable pin audit      → tạo shortcut /audit
/impeccable unpin audit

Thực thi bởi scripts/pin.mjs trong bản cài skill.

/impeccable live — cần gì để chạy

Live mode chỉ chạy khi có dev server đang chạy kèm HMR (Vite, Next.js, Bun...), hoặc một file HTML tĩnh đang mở trong trình duyệt.

Dây nối được ghi vào .impeccable/live/config.json (file này commit). Đây là file thật của repo Impeccable:

{
  "files": ["site/layouts/Base.astro"],
  "insertBefore": "</body>",
  "commentSyntax": "html",
  "cspChecked": true
}

Vòng lặp (từ reference/live.md): agent boot live.mjs → bạn mở URL app → agent poll bằng live-poll.mjs (timeout dài, 600000 ms) → bạn chọn element và hành động trong overlay → agent sinh biến thể → bạn accept/discard.

Vài điều đáng biết khi dùng:

• Đừng mở URL của serverPort. Đó là cổng của helper, không phải app. Mở đúng URL app phục vụ pageFile.
• Ký hiệu Impeccable trên thanh overlay mờ đi kèm chấm hổ phách nhấp nháy khi không có ai đang poll /poll — nghĩa là vòng lặp đã đứt, cần khởi động lại poll.
• Đứt giữa chừng thì đừng đoán. Journal dưới .impeccable/live/sessions/ là nguồn chân lý; agent chạy live-status.mjs hoặc live-resume.mjs để phát lại phần chưa xác nhận.
• Hành vi khác nhau theo harness: Claude Code chạy poll như background task; Cursor dùng poll one-shot trong terminal nền (đừng dùng --stream); Codex dùng poll foreground đã yield.

Luồng live đầu-cuối chưa được chạy thật trong lượt khảo sát này (cần dev server + harness thật); phần trên đọc từ plugin/skills/impeccable/reference/live.md và scripts/live*.mjs.

Tự chẩn đoán

node .claude/skills/impeccable/scripts/doctor.mjs           # báo cáo cho người đọc
node .claude/skills/impeccable/scripts/doctor.mjs --json    # cho lệnh trong skill
node .claude/skills/impeccable/scripts/doctor.mjs --fix     # chỉ áp các migration máy móc

doctor quét độ lệch của artifact Impeccable trong dự án: git drift, sweep từng workspace, kiểm ignore-list đối chiếu registry luật đang sống, phân giải script hook. --fix cố ý hẹp — chỉ chạy migration mức auto, những thứ không cần phán đoán. Finding không phải lỗi: mã thoát là 0 trừ khi bản thân lượt chạy hỏng.