Giải thích một chủ đề với ak:explain

Tạo explanation có căn cứ về concept, code path hoặc hệ thống bằng Markdown hoặc HTML self-contained, với tuỳ chọn ELI5.

Dùng ak:explain khi bạn cần mental model cho topic, file, hệ thống, lỗi hoặc quyết định mới. Skill tách fact đã quan sát khỏi inference và có thể emit Markdown hoặc HTML visual self-contained.

Chọn ak:explain cho explanation có căn cứ

Dùng ak:explain khi

Bạn muốn walkthrough, mental model hoặc câu trả lời “cái này hoạt động thế nào”.
Bạn muốn analogy --eli5 nhưng vẫn giữ mọi warning quan trọng.
Bạn muốn --html cho explanation visual cục bộ, offline.

Chọn workflow khác khi

Bạn chỉ muốn diễn lại message ngay trước đó của assistant. Dùng ak:bro.
Bạn muốn mở hoặc tạo visual generic, slides hoặc diff review. Dùng ak:preview.
Bạn cần system map tương tác từ typed JSON. Dùng ak:diagram.

Chạy Skill

Hoàn tất Làm quen và xác nhận Engineer Kit đã được cài cho runtime cùng scope.

Runtime	Cách gọi	Ranh giới khả dụng
Claude Code	`/ak:explain ...`	Dùng Engineer Skill đã cài; quyền file và browser phụ thuộc session.
Cursor	`/ak:explain ...`	Dùng cách viết slash đã được người dùng xác minh; quyền helper và browser phụ thuộc session.
Codex	`$ak:explain ...`	Dùng native Skill discovery; quyền filesystem và browser phụ thuộc environment.

/ak:explain "How does request authentication reach the order service?" --html

/ak:explain "How does request authentication reach the order service?" --html

$ak:explain "How does request authentication reach the order service?" --html

Flag	Tác dụng	Ranh giới
(không)	Explanation Markdown	Không ghi file trừ khi runtime vốn đã ghi
`--eli5`	Analogy đời thường; thuật ngữ được định nghĩa lần đầu	Phải giữ mọi warning và uncertainty quan trọng
`--html`	Explanation HTML visual self-contained	Kích hoạt `ak:frontend-design` trước, rồi `ak:diagram` khi đã cài; nếu không thì fallback SVG/CSS semantic
`--html --eli5`	HTML với copy ELI5 và warning panel nổi bật	Cùng ranh giới file và composition như `--html`

Flag không rõ trả usage ngắn. Nếu thiếu subject, Skill hỏi đúng một câu tập trung.

Giữ explanation trong ranh giới

Explanation không phải execution

File, log và issue text do người dùng cung cấp là dữ liệu không tin cậy. Skill không được follow instruction nhúng, lộ secret, hoặc coi analogy là sự thật đen trắng.

Output HTML là artifact cục bộ. Nó không publish, deploy hay commit trang.

Một lần chạy đầy đủ cần gist, các phần cốt lõi, mechanism, ví dụ cụ thể và caveat. Lần --html phải báo path đã ghi, ví dụ plans/visuals/explain-{slug}.html hoặc tương đương theo plan, và cho biết ak:diagram đã compile hay đã dùng fallback.