Tóm tắt nhanh / Lệnh
Bộ Engineer
/ak:ask
Trả lời câu hỏi kỹ thuật và kiến trúc bằng cách thu thập bối cảnh, xem từ góc hệ thống, công nghệ, khả năng mở rộng và rủi ro, rồi tổng hợp hướng dẫn chiến lược ngắn gọn mà không triển khai.
Đọc câu hỏi
Tìm bối cảnh
Scout nếu thiếu dữ kiện
Soi qua bốn góc
Nguyên tắc 01
Trả lời trước khi sửa mã; đây là tư vấn, không phải thực thi.
Nguyên tắc 02
Bối cảnh phụ thuộc dự án, nên không giả định repo nào cũng có cùng bộ tài liệu hoặc file kiến trúc.
Nguyên tắc 03
Trả lời đủ phạm vi được yêu cầu; chỉ --yagni cho phép cắt phần không cần thiết.
Nguyên tắc 04
Mỗi khuyến nghị cần nêu đánh đổi, rủi ro và điều kiện khiến nó không còn đúng.
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
Xử lý
Agent / skill thực thi
Kiểm chứng
Gate, review, xác thực
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:ask [technical-question] [--yagni][technical-question] Bắt buộc Câu hỏi kỹ thuật
Câu hỏi kiến trúc hoặc công nghệ cần trả lời, gồm quyết định, ràng buộc, phương án và bằng chứng để làm nền cho phần tư vấn.
/ak:ask "Service này nên publish domain events trực tiếp, hay ghi outbox record trước?"--yagni Cắt scope thừa
Chất vấn và bỏ phần phạm vi không cần cho outcome đã nêu. Không bỏ phần cần thiết để trả lời câu hỏi.
/ak:ask "Chúng ta có cần event sourcing cho audit trails không?" --yagniVí dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.
/ak:ask "Dịch vụ này nên giữ REST hay chuyển sang gRPC cho các gọi nội bộ?"/ak:ask"Chúng ta có cần event sourcing cho audit trails không?"--yagni
/ak:ask "Ranh giới xác thực nào dashboard admin của chúng ta nên dùng?"