[help request] Yêu cầu trợ giúp
Tác vụ, năng lực, skill được nêu tên hoặc câu hỏi help CLI tùy chọn để định tuyến theo catalog AgentKit đang cài.
/ak:help which workflow should I run for a bug with unknown root cause? Ctrl K
Tóm tắt nhanh / Lệnh
Bộ Engineer
/ak:help
Router trợ giúp skill đã cài
Mở chỉ mục trợ giúp AgentKit, khám phá skill đang cài từ catalog runtime hoặc frontmatter SKILL.md hiện có, rồi định tuyến user tới workflow cụ thể nhất.
01
Đọc yêu cầu
02
Dùng catalog sống
03
Khám phá frontmatter
04
Lọc candidate
Nguyên tắc 01
Trạng thái đã cài thực tế quan trọng hơn danh sách skill nhớ sẵn.
Nguyên tắc 02
Help cần định tuyến tới skill dùng được cụ thể nhất, không quảng cáo tất cả.
Nguyên tắc 03
Ví dụ lệnh phải đến từ command help hiện tại hoặc metadata SKILL.md liên quan.
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 Đọc yêu cầu Xác định user hỏi cách dùng ak, danh sách skill, skill được nêu có cài không, hay workflow nào phù hợp.
- 2 Dùng catalog sống Ưu tiên catalog skill đã cài từ runtime nếu có.
02
Xử lý
Agent / skill thực thi
- 3 Khám phá frontmatter Nếu không có catalog, tìm SKILL.md hiện tại trong project và user skill roots, chỉ đọc frontmatter của candidate liên quan.
- 4 Lọc candidate Chỉ tóm tắt skill phù hợp với yêu cầu thay vì dump toàn bộ registry.
03
Kiểm chứng
Gate, review, xác thực
- 5 Định tuyến cụ thể Khi task rõ, đề xuất skill đã cài cụ thể nhất và nói thẳng nếu skill được nhắc chưa cài.
- 6 Đọc help của lệnh Khi user cần cú pháp, đọc ak --help hiện tại hoặc help của lệnh liên quan thay vì xem prose như registry.
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:help [help request]Đối số
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ế.
Mở chỉ mục trợ giúp Khuyến nghị
/ak:help- Dùng khi:
- Khi user hỏi cách dùng AgentKit hoặc cần điểm bắt đầu.
- Kết quả:
- Mở bằng ngữ cảnh trợ giúp AgentKit đã cài, ưu tiên catalog skill sống, rồi đưa chỉ mục ngắn gọn hoặc hướng đi phù hợp tiếp theo.
Chọn workflow
/ak:help which workflow should I run for a bug with unknown root cause?- Dùng khi:
- Khi user mô tả việc cần làm nhưng chưa biết skill đã cài nào phù hợp.
- Kết quả:
- Lọc các candidate đã cài theo task, định tuyến tới skill debug hoặc điều tra cụ thể nhất, rồi giải thích ngắn gọn vì sao phù hợp.
Kiểm tra skill có sẵn
/ak:help do I have a skill for creating project documentation?- Dùng khi:
- Khi user hỏi một năng lực có tồn tại trong bản cài hiện tại hay không.
- Kết quả:
- Dùng catalog runtime hoặc frontmatter SKILL.md liên quan, chỉ báo skill đã cài khớp yêu cầu, và nói thẳng nếu chưa có skill nào.
Cần cú pháp lệnh
/ak:help how do I list installed skills from the CLI?- Dùng khi:
- Khi user cần cú pháp lệnh chính xác thay vì đề xuất skill tổng quát.
- Kết quả:
- Đọc ak help hiện tại hoặc help của subcommand liên quan trước khi đưa cú pháp, và giữ ví dụ trong phạm vi kit đã cài.
Phạm vi xử lý
- Khám phá skill đã cài
- Định tuyến workflow
- Tra candidate chỉ bằng frontmatter
- Tóm tắt command help
Artifact tạo ra
Câu trả lời trợ giúp
Mẫu đường dẫn
Skill đã cài có liên quan, lý do phù hợp, và cú pháp lệnh chính xác chỉ khi đã kiểm từ help hoặc metadata hiện tại. Đầu ra là câu trả lời định tuyến, không phải registry lệnh tĩnh.