Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:preview

Xem file hoặc tạo visual

Xem file/thư mục có sẵn hoặc tạo giải thích trực quan, sơ đồ, slide, diff, review plan và recap dự án dạng Markdown hoặc HTML độc lập.

Xác định thao tác

Xử lý stop/html

Định tuyến generation

Định tuyến review HTML

Nguyên tắc 01

View mode đọc nội dung có sẵn; generation mode tạo artifact visual mới

Nguyên tắc 02

Output --html phải độc lập và có nút đổi theme

Nguyên tắc 03

Các mode review diff, plan-review và recap tự bật HTML

Nguyên tắc 04

Cú pháp Mermaid và bố cục để xuất bản cần kiểm tra riêng

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

Khởi động

Đầu vào, phạm vi, route

1 Xác định thao tác Nếu không có tham số, hỏi người dùng chọn xem file, tạo visual, dừng server hoặc review HTML.
2 Xử lý stop/html Xử lý --stop ngay; bật chế độ HTML khi có --html hoặc khi yêu cầu diff, plan-review hay recap.
3 Định tuyến generation Dùng --explain, --slides, --diagram hoặc --ascii để tạo Markdown; từ chối topic rỗng hoặc không hợp lệ.

Xử lý

Agent / skill thực thi

4 Định tuyến review HTML Dùng --diff cho thay đổi git, --plan-review để so plan với codebase và --recap để snapshot context dự án.
5 Định tuyến chế độ xem Resolve path rõ ràng hoặc theo ngữ cảnh; file/thư mục tồn tại sẽ mở bằng markdown-novel-viewer.
6 Đọc reference Đọc reference về generation, view, visual routing, thiết kế HTML, CSS pattern, thư viện, responsive nav và template theo mode cần dùng.

Kiểm chứng

Gate, review, xác thực

7 Tạo visual Tạo prose, ASCII, Mermaid, slide, sơ đồ hoặc HTML độc lập có theme toggle bắt buộc và hành vi responsive/accessibility.
8 Áp lớp editorial Khi được bật và phù hợp intent, dùng diagram-design hoặc AntV; tôn trọng kill switch và fallback sạch khi lỗi.
9 Lưu và mở Lưu output vào thư mục visuals của plan active hoặc fallback, mở Markdown qua server hoặc HTML trực tiếp trong browser.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:preview [path]

hoặc

/ak:preview [--html] --explain|--slides|--diagram|--ascii <topic>

hoặc

hoặc

/ak:preview --stop

Đối số

[path]

Đường dẫn có sẵn

Tệp hoặc thư mục cần mở trong Markdown viewer. Path phải phân giải được trên đĩa; text không resolve được không được xem là topic trừ khi có flag tạo mới.

/ak:preview plans/checkout/plan.md

<topic> Bắt buộc

Chủ đề visual

Chủ đề không rỗng để tạo giải thích, slide, sơ đồ hoặc ASCII. Khi có nhiều flag tạo mới, flag đầu chọn mode và phần còn lại nhập vào topic này.

/ak:preview --diagram webhook lifecycle

[ref]

Mốc diff

Branch, commit, range, HEAD, pull request hoặc mặc định so với main cho --diff. PR ref cần gh.

/ak:preview --html --diff main

[plan-file]

Tệp plan

Path plan tùy chọn cho --plan-review. Nếu bỏ trống, Skill dùng ngữ cảnh plan active khi có.

/ak:preview --html --plan-review plans/checkout/plan.md

[timeframe]

Khoảng recap

Khoảng lịch sử gần đây tùy chọn cho --recap, ví dụ 30d hoặc 3m. Mặc định là hai tuần.

/ak:preview --html --recap 30d

Option dùng chung

--stop

Dừng viewer

Dừng ngay Markdown viewer server đang chạy. Không tạo hoặc mở tệp.

/ak:preview --stop

--explain

Mode giải thích

Tạo giải thích trực quan với prose, ASCII, Mermaid và code tùy chọn quanh topic bắt buộc.

/ak:preview --explain auth middleware chain

--slides

Mode slide

Tạo artifact dạng presentation khi người dùng muốn slide rõ ràng.

/ak:preview --slides deployment pipeline

--diagram

Mode sơ đồ

Tạo sơ đồ tập trung và xem bản render, không chỉ kiểm tra cú pháp Mermaid.

/ak:preview --html --diagram checkout architecture

--ascii

Mode ASCII

Tạo sơ đồ ASCII dễ đọc trong terminal. Không hỗ trợ cùng --html.

/ak:preview --ascii folder structure

--diff

Mode review diff

Tạo review visual HTML cho branch, commit, range, HEAD, PR hoặc mặc định so với main.

/ak:preview --html --diff main

--plan-review

Mode review plan

Tạo HTML so sánh plan với codebase hiện tại; cần path plan hoặc ngữ cảnh plan active.

/ak:preview --html --plan-review plans/checkout/plan.md

--recap

Mode recap

Tạo HTML snapshot ngữ cảnh project gần đây từ định danh project, lịch sử Git, status, quyết định và kiến trúc.

/ak:preview --html --recap 2w

--no-antv

Tắt AntV

Tắt visual thay thế bằng AntV cho lần chạy này nhưng vẫn cho phép fallback khác.

/ak:preview --html --diff main --no-antv

--no-diagram-design

Tắt diagram-design

Tắt visual SVG thay thế từ diagram-design cho lần chạy này, vẫn giữ fallback Mermaid hoặc bảng.

/ak:preview --html --diagram auth --no-diagram-design

--no-editorial-visuals

Tắt editorial visuals

Tắt toàn bộ lớp visual editorial bổ sung cho lần chạy này.

/ak:preview --html --recap 30d --no-editorial-visuals

Flag xuất bản / artifact

Chỉ các flag đổi artifact hoặc publish. Không phải toàn bộ option của skill.

--html

HTML độc lập

Chuyển output generation thành file HTML mở trực tiếp, CSS/JS inline.

Ví dụ

/ak:preview --html --diagram checkout architecture

Flag kết hợp

Cách các option đi cùng nhau trên cùng một lần gọi. Không thay thế bảng option ở trên.

--html kết hợp với --explain, --slides và --diagram.

--no-antv, --no-diagram-design và --no-editorial-visuals tắt từng phần của lớp visual editorial.

Mode / route nên dùng

--explain

Giải thích trực quan code, kiến trúc hoặc concept bằng prose, ASCII và Mermaid.

Xác thực:: topic required

--slides

Walkthrough dạng presentation, mỗi slide một ý.

Xác thực:: topic required

--diagram

Sơ đồ kiến trúc hoặc data-flow tập trung.

Xác thực:: topic required

--ascii

Sơ đồ ASCII đọc tốt trong terminal; không hỗ trợ cùng HTML.

Xác thực:: topic required

--diff

Review diff trực quan theo branch, commit, range, HEAD hoặc PR; tự bật HTML.

Nghiên cứu:: git data
Xác thực:: git context

--plan-review

So plan với codebase thực tế và nêu gap; tự bật HTML.

Nghiên cứu:: plan + code
Xác thực:: plan path or active plan

--recap

Snapshot context dự án theo khoảng thời gian; tự bật HTML.

Nghiên cứu:: git + architecture
Xác thực:: git history

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Xem file hoặc thư mục Khuyến nghị

/ak:preview plans/checkout/plan.md

Dùng khi:: Dùng cho giải thích trực quan, preview file hoặc sơ đồ khi cần mở path có sẵn thay vì tạo artifact mới.
Kết quả:: Resolve path, xác nhận path tồn tại, đọc reference view-mode rồi mở file Markdown hoặc thư mục trong preview reader mà không sửa file repo.

Sơ đồ Markdown

/ak:preview --diagram vòng đời webhook checkout

Dùng khi:: Dùng cho giải thích trực quan, preview file hoặc sơ đồ khi artifact Markdown dễ đọc trong terminal là đủ.
Kết quả:: Xử lý topic ở generation mode, đọc hướng dẫn generation-mode, tạo sơ đồ tập trung gồm ASCII và Mermaid, rồi kiểm tra cú pháp Mermaid bằng skill Mermaid v11.

Sơ đồ HTML

/ak:preview --html --diagram vòng đời webhook checkout

Dùng khi:: Dùng cho giải thích trực quan, preview file hoặc sơ đồ khi cần visual mở bằng browser và có điều khiển zoom.
Kết quả:: Chuyển sang HTML mode, đọc reference thiết kế/CSS/thư viện HTML và template diagram, rồi ghi file HTML độc lập với asset inline và nút đổi theme sáng/tối bắt buộc.

Review plan

/ak:preview --plan-review plans/checkout/plan.md

Dùng khi:: Dùng cho giải thích trực quan, preview file hoặc sơ đồ khi cần kiểm tra plan so với trạng thái repo thực tế.
Kết quả:: Tự bật HTML, đọc plan và code được nhắc tới, map blast radius, rồi xuất report browser về mức khớp, gap, rủi ro và kiến trúc hiện tại-so-với-dự kiến.

Review diff

/ak:preview --diff main

Dùng khi:: Dùng cho giải thích trực quan, preview file hoặc sơ đồ khi thay đổi git hiện tại cần review dễ đọc trên browser trước bàn giao.
Kết quả:: Tự bật HTML, xác định scope diff so với main, thu thập git stat/name-status và context file đổi, rồi tạo review HTML có KPI, review cards, file map và context quyết định.

Giải thích trực quan

/ak:preview --explain các lần retry webhook checkout

Dùng khi:: Khi một khái niệm cần giải thích trực quan thay vì mở file có sẵn.
Kết quả:: Xử lý topic ở generation mode, ghi artifact giải thích trực quan tập trung và không mutate file nguồn đang được giải thích.

Slide

/ak:preview --slides câu chuyện ra mắt checkout

Dùng khi:: Khi phần giải thích nên là slide deck thay vì một sơ đồ.
Kết quả:: Sinh artifact slide cho topic, giữ narrative trong phạm vi yêu cầu và báo path output.

Chỉ ASCII

/ak:preview --ascii vòng đời webhook checkout

Dùng khi:: Khi sơ đồ phải đọc được trong terminal, không cần HTML.
Kết quả:: Ghi sơ đồ ASCII đọc được trên terminal cho topic và bỏ đường preview HTML/browser.

Recap phiên

/ak:preview --recap 7d

Dùng khi:: Khi cần recap trực quan công việc gần đây theo khung thời gian.
Kết quả:: Thu thập khung thời gian đã yêu cầu, sinh visual recap và báo path artifact mà không viết lại git history.

Phạm vi xử lý

Xác định thao tác
Xử lý stop/html
Định tuyến generation
Định tuyến review HTML
Định tuyến chế độ xem
Đọc reference

Artifact tạo ra

Output preview

Mẫu đường dẫn

{plan_dir}/visuals/{slug}.md hoặc {slug}.html; view mode mở path có sẵn

Output là giải thích trực quan, sơ đồ, slide, report review hoặc browser view cho file/thư mục có sẵn.

Xem file hoặc tạo visual

Bản đồ thực thi

Cú pháp, đối số, subcommand

Đối số

Option dùng chung

Flag xuất bản / artifact

Flag kết hợp

Mode / route nên dùng

Prompt mẫu

Phạm vi xử lý

Artifact tạo ra

Skill liên quan

Tiếp theo