Tóm tắt nhanh / Lệnh

Bộ Marketing

/ak:ask

Tư vấn kiến trúc trước khi sửa mã

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.

01

Đọc câu hỏi

02

Tìm bối cảnh

03

Scout nếu thiếu dữ kiện

04

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.

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 Đọc câu hỏi Xác định quyết định thiết kế, đánh đổi hoặc đánh giá best practice mà người dùng thật sự cần trả lời.
  2. 2 Tìm bối cảnh Đọc hướng dẫn repo, README và tài liệu liên quan; kiểm chứng nhận định trong tài liệu bằng source, test, cấu hình hoặc bằng chứng runtime khi cần.
02

Xử lý

Agent / skill thực thi

  1. 3 Scout nếu thiếu dữ kiện Nếu bối cảnh kiến trúc chưa đủ, dùng ak:scout để lấy dữ kiện codebase thay vì tư vấn từ giả định.
  2. 4 Soi qua bốn góc Đánh giá ranh giới hệ thống, lựa chọn công nghệ, khả năng mở rộng/độ tin cậy và rủi ro kèm cách giảm thiểu và điều kiện thất bại.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Tổng hợp hướng dẫn Gộp các góc nhìn thành phân tích kiến trúc trực diện, khuyến nghị, hướng dẫn công nghệ, chiến lược triển khai và bước tiếp theo.
  2. 6 Giữ ngắn gọn Trung thực, thẳng và đúng trọng tâm; có phương án thay thế và điểm kiểm chứng, nhưng không trượt sang viết mã.

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

Quyết định kiến trúc Khuyến nghị
/ak:ask "Dịch vụ này nên giữ REST hay chuyển sang gRPC cho các gọi nội bộ?"
Dùng khi:
Dùng khi cần câu trả lời chiến lược trước khi lập kế hoạch hoặc viết mã.
Kết quả:
Thu thập bối cảnh, so sánh ranh giới và đánh đổi, rồi trả hướng dẫn trực diện.
Phản biện kiến trúc bằng YAGNI
/ak:ask "Chúng ta có cần event sourcing cho audit trails không?" --yagni
Dùng khi:
Dùng khi muốn khuyến nghị phản biện và cắt phạm vi không cần thiết.
Kết quả:
Đánh giá đủ câu hỏi, rồi chỉ cắt phần không cần cho kết quả đã nêu.
Đánh giá best practice
/ak:ask "Ranh giới xác thực nào dashboard admin của chúng ta nên dùng?"
Dùng khi:
Dùng để có chiến lược triển khai, tiêu chí thử nghiệm và điểm kiểm chứng mà không sửa file.
Kết quả:
Trả khuyến nghị, phương án khác, rủi ro và bước tiếp theo thay vì patch mã.

Phạm vi xử lý

  • Ranh giới hệ thống
  • Chiến lược công nghệ
  • Mở rộng và độ tin cậy
  • Phân tích rủi ro
  • Đánh đổi quyết định

Skill liên quan

Tiếp theo