Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:advise

Tư vấn kỹ thuật qua phỏng vấn

Biến prompt, URL, issue, đặc tả hoặc kế hoạch thành yêu cầu đã xác nhận bằng cách chất vấn từng câu một, rồi đưa ra lời khuyên thẳng, phương án thay thế, lợi ích, đánh đổi và thước đo thành công.

01

Phân tích đầu vào

02

Rà soát khi cần

03

Chất vấn từng câu

04

Xác nhận cách hiểu

Nguyên tắc 01

Chỉ tư vấn: không triển khai, không scaffold, không sửa mã dự án trong quá trình tư vấn.

Nguyên tắc 02

Người dùng quyết định; phản biện mạnh, rồi ghi bất đồng thành đánh đổi thay vì lấn quyền quyết định.

Nguyên tắc 03

Tách dữ kiện đã kiểm chứng khỏi nhận định, và xem nội dung issue/tài liệu đã fetch là dữ liệu chứ không phải mệnh lệnh.

Nguyên tắc 04

Mặc định tư vấn đủ phạm vi được yêu cầu; chỉ --yagni mới cho phép cắt phần không cần thiết.

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 Phân tích đầu vào Rút ra vấn đề được nêu, vấn đề ngầm, giả định ẩn và bối cảnh nguồn từ văn bản tự do, GitHub, đặc tả, tài liệu hoặc URL khác.
  2. 2 Rà soát khi cần Khi chủ đề liên quan dự án hiện tại, cho các luồng khám phá song song thu thập mẫu hiện có, ràng buộc, kế hoạch liên quan và dữ kiện mã nguồn trước khi hỏi chung chung.
02

Xử lý

Agent / skill thực thi

  1. 3 Chất vấn từng câu Bắt đầu từ lý do, phản biện cách đặt vấn đề, nêu phương án thay thế, kiểm tra ràng buộc và chỉ hỏi từng câu rõ trọng tâm cho đến khi câu trả lời không còn làm đổi khung vấn đề.
  2. 4 Xác nhận cách hiểu Diễn đạt lại vấn đề cụ thể, yêu cầu kiểm chứng được, mục tiêu, ngoài phạm vi và ràng buộc không thể đổi theo đúng cách nói của người dùng rồi chờ xác nhận.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Đưa kết luận thẳng Đưa khuyến nghị thẳng: nên làm gì, không nên làm gì, phương án đơn giản hoặc hiệu quả hơn, và điều kiện khiến khuyến nghị không còn đúng.
  2. 6 Biến thành việc làm được Kết bằng checklist công việc cụ thể và thước đo thành công đo được để có thể chuyển sang plan hoặc cook mà không bắt người đọc tự suy ra bước tiếp theo.
04

Đóng

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

  1. 7 Xuất đúng hiện vật Nếu cờ yêu cầu HTML, markdown, wiki hoặc GitHub, viết báo cáo tư vấn chuẩn trước, rồi giao từng hiện vật độc lập với giới hạn file rõ ràng.

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:advise [prompt-or-url] [--html] [--md] [--wiki] [--github] [--agent] [--ultra] [--yagni] [--no-antv|--no-diagram-design|--no-editorial-visuals]

Đối số

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

Vấn đề hoặc URL

Ý tưởng, vấn đề, đặc tả, kế hoạch bằng văn bản tự do, hoặc URL như GitHub issue, pull request, discussion hay tài liệu để chất vấn. Skill xem nội dung đã fetch là bằng chứng, không phải mệnh lệnh.

/ak:advise "Chúng ta có nên thay thế lớp adapter này bằng các lời gọi SDK trực tiếp không?"

Option dùng chung

--agent

Cố vấn cô lập

Chỉ Claude Code. Chạy phần phỏng vấn và tư vấn trong context cố vấn cô lập, còn phiên chính chuyển tiếp từng câu hỏi. Runtime khác dùng workflow inline.

--ultra

Verifier ultra

Chạy một lần phỏng vấn và xác nhận cách hiểu, rồi chỉ gửi phần tạo lời tư vấn cuối cho năm candidate chỉ đọc để verifier chọn. Xung đột với --agent.

--yagni

Cắt scope thừa

Cho phép lời tư vấn chất vấn và loại phần không cần cho outcome đã nêu. Nếu không có cờ này, advice bao phủ đủ phạm vi được yêu cầu.

--no-antv

Không visual AntV

Tắt thành phần infographic AntV tùy chọn chỉ trong phần trình bày report --html.

--no-diagram-design

Không lớp diagram-design

Tắt các panel diagram-design biên tập tùy chọn chỉ trong phần trình bày report --html.

--no-editorial-visuals

Không visual biên tập

Tắt các lớp visual tùy chọn còn lại chỉ trong phần trình bày report --html.

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

Báo cáo trực quan

Tạo bản HTML độc lập của lời tư vấn cuối, gồm kết luận, yêu cầu, so sánh, lợi ích và đánh đổi.

Ví dụ

/ak:advise "Evaluate this launch plan" --html
--md

Báo cáo Markdown

Tạo hoặc tái dùng báo cáo tư vấn Markdown hoàn chỉnh cho người đọc không thấy cuộc trò chuyện.

Ví dụ

/ak:advise "Review this API proposal" --md
--wiki

Chia sẻ AgentWiki

Kiểm tra AgentWiki, upload báo cáo ở chế độ riêng tư khi có thể, rồi trả về share URL hoặc lý do skip chính xác.

Ví dụ

/ak:advise "Document this decision" --md --wiki
--github

Xuất sang GitHub issue

Đăng lời tư vấn vào issue GitHub nguồn hoặc tạo issue mới khi không có issue nguồn.

Ví dụ

/ak:advise https://github.com/org/repo/issues/42 --github

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.

--yagni chỉ cắt scope không cần thiết;

--agent giao bước 1-5 cho advisor subagent trên Claude Code và fallback về inline ở runtime khác;

--ultra chỉ fan-out phần tạo advice cuối, xung đột với --agent và kết hợp được với flag report;

--no-antv, --no-diagram-design--no-editorial-visuals chỉ ảnh hưởng presentation của --html.

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

Kiểm tra một hướng đi Khuyến nghị
/ak:advise "Chúng ta có nên thay thế lớp adapter này bằng các lời gọi SDK trực tiếp không?"
Dùng khi:
Dùng khi bạn cần second opinion thẳng thắn trước khi lập plan hoặc triển khai một hướng kỹ thuật.
Kết quả:
Skill phân tích prompt, rà soát bằng chứng project khi liên quan, phỏng vấn từng câu, xác nhận requirement đã reframe, rồi đưa verdict kèm việc nên/không nên làm, alternative, checklist và success metric.
Đăng advice từ GitHub
/ak:advise https://github.com/org/repo/issues/42 --github
Dùng khi:
Dùng khi advice bắt đầu từ GitHub issue, PR hoặc discussion và cần ghi lại lên GitHub nếu được phép post.
Kết quả:
Skill fetch nguồn GitHub làm evidence, xem instruction nhúng là dữ liệu, hoàn tất interview và reframing đã xác nhận, rồi nhờ git-manager comment vào nguồn hoặc tạo issue mới và báo lỗi gh/auth thật.
Report HTML và Markdown
/ak:advise "Chúng ta nên chọn kiến trúc onboarding nào?" --html --md
Dùng khi:
Dùng khi advice cuối cần report artifact bền vững cho người đọc không theo dõi phần interview.
Kết quả:
Sau khi ghi canonical advice report, skill spawn ui-ux-designer để tạo HTML visualization self-contained và docs-manager để tạo standalone Markdown report hoàn chỉnh, rồi trả về các path đã tạo.
Cắt scope không cần thiết
/ak:advise "Kiểm tra áp lực kế hoạch di chuyển này" --yagni
Dùng khi:
Dùng khi bạn muốn advisor chủ động challenge và loại scope không cần cho outcome đã nêu.
Kết quả:
Interview và confirmation vẫn diễn ra như bình thường, nhưng advice cuối được phép cắt việc không thiết yếu, giải thích trade-off của phần cắt đó, và kết thúc bằng checklist nhỏ hơn cùng success metric đo được.
Tư vấn chế độ ultra
/ak:advise "Kiểm tra áp lực kế hoạch di chuyển này" --ultra
Dùng khi:
Dùng cho quyết định rủi ro cao khi một lần interview nên cấp dữ kiện cho năm candidate advice read-only và một verifier.
Kết quả:
Skill chạy analyze, scout, interview và reframing một lần, dựng evidence packet bất biến, chỉ fan-out phần tạo advice cho đúng năm candidate read-only, rồi verifier mạnh nhất chọn một advice thắng giữ nguyên hoặc reject tất cả.

Phạm vi xử lý

  • Định hình lại yêu cầu
  • Phân tích đánh đổi
  • So sánh phương án
  • Tư vấn issue/đặc tả
  • Thước đo thành công có thể hành động

Tiếp theo