Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:diagram

Bản đồ hệ thống tương tác

Compile JSON IR có kiểu thành bản đồ hệ thống tương tác đã kiểm, SVG, fragment nhúng được, và HTML reader tự chứa mà không cần trình duyệt.

Chọn archetype

Soạn IR có kiểu

Áp invariant schema

Chọn cờ compile

Nguyên tắc 01

Chọn theo artifact cần tạo, không chọn chỉ vì có chữ diagram.

Nguyên tắc 02

JSON IR có kiểu là nguồn; compile offline thành SVG, fragment hoặc HTML.

Nguyên tắc 03

Cùng byte IR phải cho ra cùng byte output.

Nguyên tắc 04

Phác thảo whiteboard, biểu đồ in, và Mermaid inline thuộc skill khác.

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 Chọn archetype Khớp ý định với architecture, workflow, sequence, dataflow hoặc lifecycle trước khi viết IR.
2 Soạn IR có kiểu Đặt schema_version, diagram_type, meta, preset hình, theme và animation trace hữu hạn nếu cần.

Xử lý

Agent / skill thực thi

3 Áp invariant schema Dùng enum role node chặt, ID chữ-số-gạch ngang, và khoảng lane workflow đủ rộng.
4 Chọn cờ compile Chọn --format svg, fragment hoặc html kèm --preset, --theme và --out cho file đích.

Kiểm chứng

Gate, review, xác thực

5 Compile offline Chạy compiler Node trên IR có kiểu, không browser, mạng, telemetry hay tải font.
6 Giữ chuyển động hữu hạn Animation trace, nếu có, tối đa tám giây và tắt khi prefers-reduced-motion.

Đóng

Báo cáo, bàn giao, artifact

7 Xác minh byte Cùng byte IR phải cho ra cùng byte output SHA-256 trên mọi môi trường.
8 Bàn giao artifact Trả HTML reader tự chứa, SVG sạch, hoặc fragment nhúng được tại path --out đã yêu cầu.

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

Đối số

[input-file]

File IR có kiểu

Path tùy chọn tới sơ đồ JSON IR có kiểu. Chỉ bỏ trống khi IR sẽ được soạn trong phiên trước khi compile.

/ak:diagram architecture.json --format html --out ./build/diagram.html

Option dùng chung

--format <svg|fragment|html>

Định dạng output

Compile thành SVG vector sạch, fragment HTML scoped để nhúng, hoặc HTML reader tương tác độc lập. Đường compile mặc định là HTML reader tự chứa.

/ak:diagram architecture.json --format svg --out ./build/diagram.svg

--preset <classic|signal-flow|blueprint|editorial>

Preset hình ảnh

classic là nền sạch, signal-flow dùng ánh emerald/cyan, blueprint là xanh kỹ thuật, editorial là serif ấm.

/ak:diagram architecture.json --format fragment --preset signal-flow --theme dark

--theme <light|dark>

Theme màu

Theme sáng hoặc tối cho SVG, fragment hoặc HTML reader đã compile. Animation trace hữu hạn, nếu có, không quá tám giây và tôn trọng reduced motion.

/ak:diagram architecture.json --format html --theme dark --out ./build/diagram.html

--out <path>

Đường dẫn output

File đích cho artifact đã compile. Cùng byte IR cho ra cùng byte output SHA-256 trên mọi môi trường.

/ak:diagram architecture.json --format html --out ./build/diagram.html

Mode / route nên dùng

--format svg|fragment|html

Định dạng compile

Nghiên cứu:: schema-and-reader
Review:: Refuse unknown formats
Xác thực:: Artifact matches format

--preset

Preset hình

Nghiên cứu:: classic/signal-flow/blueprint/editorial
Review:: Keep enum values
Xác thực:: Preset applied

--theme

Sáng hoặc tối

Nghiên cứu:: light|dark
Review:: Keep enum values
Xác thực:: Theme applied

--out

Path output

Nghiên cứu:: destination file
Review:: Do not overwrite without path
Xác thực:: File written

Tính năng đặc biệt

Không mạng

Compile chạy offline trong Node.js thuần; không gọi mạng, telemetry hay tải font.

Giảm chuyển động

Animation trace luôn hữu hạn và tự tắt khi prefers-reduced-motion.

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ế.

Compile IR mặc định

/ak:diagram architecture.json

Dùng khi:: IR có kiểu đã có và HTML reader tương tác mặc định là đủ.
Kết quả:: Chọn archetype từ IR, compile architecture.json offline thành HTML reader tự chứa, rồi báo path output mà không mở trình duyệt hay gọi mạng.

HTML reader Khuyến nghị

/ak:diagram architecture.json --format html --theme dark --out ./build/diagram.html

Dùng khi:: Artifact mong muốn là HTML reader tương tác độc lập với theme tối.
Kết quả:: Compile IR có kiểu offline thành HTML reader tự chứa tại ./build/diagram.html, áp theme tối, và giữ mọi chuyển động trace hữu hạn kèm tắt reduced-motion.

SVG vector

/ak:diagram architecture.json --format svg --out ./build/diagram.svg

Dùng khi:: Cần file vector sạch thay vì reader tương tác.
Kết quả:: Compile architecture.json thành SVG xác định tại ./build/diagram.svg, chạy offline trong Node.js, và không xuất HTML, fragment hay ảnh tĩnh render bằng browser.

Fragment nhúng được

/ak:diagram architecture.json --format fragment --preset signal-flow --theme dark

Dùng khi:: Bản đồ phải nhúng vào trang có sẵn thay vì xuất thành file độc lập.
Kết quả:: Compile fragment HTML scoped với preset signal-flow và theme tối, giữ compile offline, rồi báo fragment dùng để nhúng chứ không phải reader độc lập.

Phạm vi xử lý

Archetype architecture, workflow, sequence, dataflow và lifecycle
JSON IR có kiểu với invariant schema và truy vấn graph có căn cứ
Compile Node offline ra SVG, fragment scoped và HTML reader
Preset hình classic, signal-flow, blueprint và editorial
Chuyển động trace hữu hạn và tắt khi reduced-motion

Artifact tạo ra

Sơ đồ đã compile

Mẫu đường dẫn

<out>.html | <out>.svg | fragment HTML scoped

HTML reader tương tác tự chứa, SVG vector sạch, hoặc fragment scoped để nhúng, compile từ JSON IR có kiểu.