Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:show-off

Trang HTML trình diễn

Tạo trang showcase tự chứa theo preference, hỗ trợ song ngữ hoặc một ngôn ngữ, cổng chất lượng frontend-design, tùy chọn chụp ảnh, publish và lớp visual biên tập.

01

Resolve preference

02

Đăng ký plan

03

Phân tích nhiệm vụ

04

Viết nội dung

Nguyên tắc 01

Showcase phải đạt chất lượng UI sản phẩm, không phải demo tạm bợ

Nguyên tắc 02

Preference là điều khiển quy trình và phải resolve trước khi lập plan

Nguyên tắc 03

Screenshot và publishing có thể tắt nhưng phải thể hiện trong plan

Nguyên tắc 04

Không đưa credential hoặc API key vào HTML sinh ra

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.

01

Khởi động

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

  1. 1 Resolve preference Đọc preference về screenshot, publishing và ngôn ngữ trước khi phân tích nội dung; áp dụng override rõ ràng và lưu thay đổi lâu dài khi cần.
  2. 2 Đăng ký plan Gọi project-management, tạo thư mục plan theo ngày, ghi argument/preference, rồi đăng ký task luôn chạy cùng task chụp/publish có điều kiện.
02

Xử lý

Agent / skill thực thi

  1. 3 Phân tích nhiệm vụ Chia yêu cầu thành hero và hai đến sáu section, tìm bằng chứng trên web và nạp writing style nếu có.
  2. 4 Viết nội dung Viết `assets/showoff/<mission-name>/content.md` với các section có cấu trúc, citation và đúng chế độ ngôn ngữ đã resolve.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Publish bản nội dung Nếu bật publishing, publish markdown bằng agentwiki; nếu không, giữ cục bộ và đánh dấu publish là skipped.
  2. 6 Thiết kế HTML Kích hoạt frontend-design để dựng trang tự chứa có hero mạnh, section cuộn mượt, responsive theo tỷ lệ, nút theme, font hỗ trợ tiếng Việt và lớp visual tùy chọn.
04

Đóng

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

  1. 7 Chụp ảnh và publish Chụp ảnh từng section khi bật screenshot, chỉ dùng fallback rws khi publishing giúp trang có URL công khai, rồi publish/cập nhật static site hoặc báo đường dẫn cục bộ.
  2. 8 Mở trang và bàn giao Mở trang HTML kết quả, chạy kiểm tra bàn giao thiết kế theo năm tiêu chí và sửa lỗi hoặc ghi rõ hạn chế đã biết.

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:show-off [markdown-or-prompt] [--no-screenshots] [--no-publish] [--languages en|vi|en,vi] [--no-antv|--no-diagram-design|--no-editorial-visuals]

Đối số

[markdown-or-prompt] Bắt buộc

Nhiệm vụ showcase

Prompt, brief Markdown hoặc tư liệu nguồn cần chuyển thành showcase tự chứa. Nêu mission, audience, chuẩn bằng chứng, ranh giới publish, lựa chọn screenshot và ngôn ngữ; không đưa credential hoặc dữ liệu riêng tư nhạy cảm.

/ak:show-off "Tạo demo ra mắt chỉ bằng tiếng Anh từ release-notes.md. Chỉ local, không screenshots, chỉ cho lần chạy này. Trích dẫn mọi claim bên ngoài và mở HTML cuối để review."

Option dùng chung

--no-screenshots

Bỏ screenshot

Tắt chụp section cục bộ và fallback ReviewWeb từ xa, rồi đánh dấu capture là skipped. Nếu không có “for this run only”, preference này được lưu trước khi lập plan.

/ak:show-off "Biến launch note này thành showcase" --no-screenshots
--no-publish

Chỉ cục bộ

Bỏ publish document/static site qua agentwiki và giữ output cục bộ; điều này cũng làm fallback ReviewWeb không đủ điều kiện. Nếu không nói chỉ một lần, opt-out sẽ được lưu.

/ak:show-off "Tạo story cột mốc sản phẩm" --no-publish
--languages en|vi|en,vi

Chế độ ngôn ngữ

Chọn nội dung chỉ tiếng Anh, chỉ tiếng Việt hoặc song ngữ Việt/Anh. Chế độ một ngôn ngữ không được thêm ngôn ngữ còn lại hoặc toggle song ngữ.

/ak:show-off "Tạo story cột mốc hướng tới khách hàng" --languages en
--no-antv

Không lớp AntV

Tắt tile AntV Infographic cho panel KPI, ranked-list hoặc quadrant ngoài hero trong lần chạy này; hero do frontend-design vẫn bắt buộc.

/ak:show-off "Tạo story ra mắt" --no-antv
--no-diagram-design

Không diagram-design

Tắt lớp tăng cường diagram-design cho visual kiến trúc, quy trình và data-flow trong các section.

/ak:show-off "Tạo showcase recap kiến trúc" --no-diagram-design
--no-editorial-visuals

Không visual biên tập

Tắt cả hai lớp visual biên tập bổ sung ngoài hero nhưng vẫn giữ phần dựng showcase tự chứa cốt lõi.

/ak:show-off "Tạo recap dự án" --no-editorial-visuals

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

Showcase mặc định Khuyến nghị
/ak:show-off "Create a showcase page for our realtime dashboard launch"
Dùng khi:
Dùng khi cần một trang demo hoặc presentation tự chứa, được thiết kế chỉn chu.
Kết quả:
Resolve preference show-off, đăng ký plan, viết nội dung có citation, dựng HTML đạt chuẩn frontend-design, chụp từng section, publish khi bật và chạy cổng bàn giao.
Bỏ qua screenshot
/ak:show-off "Turn this launch note into a showcase" --no-screenshots
Dùng khi:
Dùng khi chỉ cần trang HTML cục bộ hoặc đã publish, không cần xuất ảnh từng section.
Kết quả:
Lưu lựa chọn tắt screenshot trừ khi chỉ áp dụng một lần, đánh dấu capture là skipped, vẫn viết nội dung, dựng trang showcase, mở trang và báo đường dẫn HTML.
Trang tiếng Anh chỉ chạy local
/ak:show-off "Make a customer-facing product milestone story" --no-publish --languages en
Dùng khi:
Dùng khi showcase phải giữ cục bộ và chỉ dùng copy tiếng Anh, không có toggle song ngữ.
Kết quả:
Áp preference chỉ chạy local và ngôn ngữ tiếng Anh, bỏ qua agentwiki publishing và fallback rws, tạo markdown có citation cùng artifact HTML, rồi báo output cục bộ.
Recap kiến trúc ít lớp visual
/ak:show-off "Create an architecture recap showcase" --no-diagram-design --no-editorial-visuals
Dùng khi:
Dùng khi muốn showcase không dùng diagram-design hoặc visual biên tập bổ sung ngoài hero.
Kết quả:
Giữ hero frontend-design bắt buộc và các section responsive, tắt diagram-design cùng visual biên tập bổ sung, rồi đi qua các cổng chụp ảnh, publish và bàn giao như bình thường.

Phạm vi xử lý

  • HTML tự chứa
  • copy showcase song ngữ
  • ảnh từng section
  • publish static
  • review bàn giao

Tiếp theo