Skill
Nhận câu trả lời kiến trúc với ak:ask
Đặt câu hỏi kỹ thuật tập trung, dựa câu trả lời trên bằng chứng hiện tại của project và nhận khuyến nghị ngắn gọn mà không triển khai.
Dùng ak:ask khi bạn cần câu trả lời trực tiếp về kỹ thuật hoặc kiến trúc trước
khi sửa code. Skill khám phá ngữ cảnh project liên quan, đánh giá câu hỏi từ góc
nhìn thiết kế, công nghệ, khả năng mở rộng và rủi ro, rồi kết thúc bằng bước tiếp
theo thực tế thay vì triển khai.
Chọn ak:ask cho một lần tư vấn tập trung
Dùng ak:ask khi
- Bạn cần khuyến nghị về kiến trúc hoặc công nghệ.
- Bạn muốn so sánh pattern, framework hoặc ranh giới giải pháp.
- Bạn cần trade-off, rủi ro và bước xác minh trước khi quyết định.
- Bạn muốn câu trả lời dựa trên bằng chứng mà không qua phỏng vấn hay thay đổi workspace.
Chọn workflow khác khi
- Bạn cần định hình lại vấn đề qua phỏng vấn từng câu một. Dùng
ak:advise. - Bạn cần khám phá nhiều hướng bàn giao. Dùng
ak:brainstorm. - Bạn cần tìm tệp, symbol, test hoặc quan hệ trước. Dùng
ak:scout. - Bạn muốn có kế hoạch hoặc triển khai. Chỉ tiếp tục với
ak:planhoặcak:cooksau khi chấp nhận hướng đi.
Chuẩn bị project và runtime
Trước khi bắt đầu:
- Hoàn tất Làm quen, và xác nhận Engineer Kit đã được cài cho runtime và scope bạn đang dùng.
- Mở project có kiến trúc hoặc ràng buộc hiện tại cần dùng cho câu trả lời.
- Nêu quyết định, ràng buộc đã biết và các phương án đã cân nhắc.
- Bao gồm bằng chứng hoặc điều kiện chấp nhận giúp câu trả lời hữu ích.
| Runtime | Cách gọi | Ranh giới khả dụng |
|---|---|---|
| Claude Code | /ak:ask ... | Chạy như một Engineer Skill đã cài qua cơ chế native hoặc plugin tường minh. |
| Cursor | /ak:ask ... | Dùng cách viết slash đã được người dùng xác minh cho Engineer Skill; chưa xác lập tính tương đương rộng hơn về tool. |
| Codex | $ak:ask ... | Dùng cơ chế khám phá native của Codex; điều này không ngụ ý mọi thành phần runtime của Engineer đều tương đương. |
Chạy Skill
/ak:ask "Should this service publish domain events directly, or write an outbox record first? Compare reliability, operational cost, and migration risk against the current repository patterns."/ak:ask "Should this service publish domain events directly, or write an outbox record first? Compare reliability, operational cost, and migration risk against the current repository patterns."$ak:ask "Should this service publish domain events directly, or write an outbox record first? Compare reliability, operational cost, and migration risk against the current repository patterns."Skill nhận một câu hỏi kỹ thuật. Mặc định, Skill xử lý đầy đủ scope được yêu cầu
và không thêm phần việc ngoài yêu cầu. Thêm --yagni để challenge và cắt scope
không cần thiết cho outcome đã nêu. Skill không có output tệp mặc định.
Mô tả câu hỏi rõ ràng
Input hữu ích cần nêu:
- Quyết định: Nêu điều cần chọn hoặc cần hiểu.
- Ngữ cảnh: Xác định hệ thống, người dùng, interface và thiết kế hiện tại bị ảnh hưởng.
- Ràng buộc: Bao gồm yêu cầu tương thích, độ tin cậy, quy mô, bảo mật, thời gian hoặc bảo trì.
- Phương án: Nêu các lựa chọn nghiêm túc đang được cân nhắc.
- Bằng chứng: Trỏ tới source, test, cấu hình, tài liệu hoặc số đo hiện tại cần làm nền cho câu trả lời.
- Phép thử thành công: Giải thích khuyến nghị cần giúp bạn quyết định bước gì.
Hiểu những gì diễn ra trong một lần chạy
- Skill khám phá nguồn thẩm quyền của project. Skill đọc chỉ dẫn repo, README gốc và tuyến tài liệu liên quan.
- Skill xác minh tuyên bố hiện tại. Skill kiểm tra source, test, cấu hình và bằng chứng runtime khi câu hỏi phụ thuộc vào chúng.
- Skill bù khoảng trống bằng chứng. Nếu ngữ cảnh kiến trúc chưa đủ, Skill có
thể chuyển một lượt tìm kiếm giới hạn qua
ak:scout. - Skill đánh giá bốn góc nhìn. Skill xem xét ranh giới hệ thống, lựa chọn công nghệ, khả năng mở rộng và độ tin cậy, cùng rủi ro và trade-off.
- Skill tổng hợp khuyến nghị. Skill ưu tiên giải pháp nhỏ nhất đáp ứng bằng chứng và ràng buộc.
- Skill xác định bước tiếp theo. Skill đề xuất proof of concept, số đo hoặc decision gate thay vì bắt đầu triển khai.
Giữ câu trả lời ở phạm vi tư vấn
Tư vấn không phải phê duyệt triển khai
ak:ask chỉ phân tích. Skill không sửa code, áp dụng migration, phê duyệt kiến
trúc, xuất bản nội dung hay cho phép workflow sau đó tự hành động.
Workflow được định nghĩa trong source không yêu cầu provider, credential, dịch vụ trả phí hay xuất bản ra ngoài. Việc kiểm tra project bị giới hạn bởi tệp và tool có trong phiên hiện tại. Hãy giữ dữ liệu riêng tư hoặc nhạy cảm không liên quan ở ngoài scope bằng chứng.
Xác minh kết quả
Câu trả lời hữu ích nên có:
- Phân tích kiến trúc dựa trên ngữ cảnh hiện tại.
- Hướng đi được khuyến nghị cùng lý do rõ ràng.
- Các phương án có ý nghĩa và trade-off của chúng.
- Hướng dẫn công nghệ với lợi ích và chi phí liên quan.
- Chiến lược xác minh hoặc triển khai theo giai đoạn.
- Bước tiếp theo cụ thể và khoảng trống bằng chứng còn lại.
Hãy coi kết quả là hỗ trợ quyết định. Xác minh các tuyên bố quan trọng về bảo mật, hiệu năng và production bằng workflow chuyên môn hoặc test sở hữu chúng.
Khắc phục sự cố hoặc tiếp tục
| Triệu chứng | Bước tiếp theo an toàn |
|---|---|
| Câu trả lời quá chung chung | Bổ sung module hiện tại, ràng buộc, phương án và tiêu chí quyết định có thể quan sát. |
| Câu trả lời giả định sai kiến trúc | Trỏ tới chỉ dẫn repo, tuyến kiến trúc và source hoặc test sở hữu hành vi. |
| Cần thêm bằng chứng repo | Thu hẹp sự thật còn thiếu và dùng ak:scout trước khi hỏi lại. |
| Quyết định cần khám phá stakeholder | Chuyển sang ak:advise để xác nhận cách định hình lại hoặc ak:brainstorm để so sánh hướng bàn giao. |
| Runtime không nhận ra Skill | Xác nhận target và scope, khởi động lại phiên runtime, rồi làm theo Runtime không tìm thấy Skill hoặc Agent. |
Chỉ tiếp tục với ak:plan sau khi đã chấp nhận khuyến nghị và các gate xác minh.
Dùng ak:cook khi contract triển khai và quyền thực hiện đã rõ.
Biết giới hạn hiện tại
- Câu trả lời bị giới hạn bởi bằng chứng có trong phiên hiện tại.
- Bốn góc nhìn tổ chức một lần tư vấn; chúng không độc lập chứng minh khuyến nghị.
- Skill không thay thế chẩn đoán cho lỗi cụ thể hay review chuyên môn cho quyết định phát hành.
- Cách gọi slash trên Cursor là bằng chứng do người dùng xác minh, không phải bằng chứng về tính tương đương đầy đủ của runtime.
- Stable và beta đóng gói cùng workflow
ak:ask.
Điều chỉnh độ sâu giải thích với ak:coding-level
Lưu preference về kinh nghiệm coding từ level 0 đến 5 và hiểu nơi automatic session injection được hỗ trợ.
Định hình hướng triển khai với ak:brainstorm
Biến ý định chưa đầy đủ thành outcome có giới hạn, so sánh các hướng khả thi và chuyển giao quyết định dựa trên bằng chứng.