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.

Đọc yêu cầu

Dùng catalog sống

Khám phá frontmatter

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.

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

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.

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 [topic|skill|command]

Đối số

[topic|skill|command]

Chủ đề, skill, hoặc lệnh

Chủ đề, skill được nêu tên, hoặc lệnh CLI tùy chọn để định tuyến theo catalog AgentKit đang cài. /ak:help không đối số mở chỉ mục trợ giúp.

/ak:help which workflow should I run for a bug with unknown root cause?

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ứ không dump mọi skill.

Chọn một chủ đề

/ak:help debugging unknown root cause

Dùng khi:: Khi user nêu một chủ đề nhưng chưa biết skill đã cài nào phù hợp.
Kết quả:: Lọc candidate đã cài theo chủ đề debugging, định tuyến tới skill điều tra cụ thể nhất, rồi giải thích ngắn gọn sự phù hợp từ catalog sống.

Kiểm tra skill có tên

/ak:help docs

Dùng khi:: Khi user hỏi một skill có tên 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, báo skill docs đã cài hay chưa, và nói thẳng nếu skill được nhắc bị thiếu hoặc bị shadow.

Cần cú pháp lệnh

/ak:help ak skills

Dùng khi:: Khi user cần cú pháp lệnh CLI 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 lệnh liên quan trước khi đưa cú pháp, và giữ ví dụ trong phạm vi kit đã cài thay vì coi prose như registry.

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.