Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:predict

Phân tích trước bằng nhiều persona

Năm persona chuyên gia phân tích độc lập một đề xuất thay đổi, tranh luận mâu thuẫn và đưa ra verdict GO, CAUTION hoặc STOP trước khi triển khai.

Đọc đề xuất

Đọc code được chỉ định

Phân tích độc lập

Tìm đồng thuận

Nguyên tắc 01

Dùng trước feature lớn, refactor quan trọng, đổi kiến trúc, so sánh hướng kỹ thuật hoặc stress-test giả định

Nguyên tắc 02

Không dùng cho thay đổi nhỏ, việc đã approve sẵn hoặc nâng dependency thuần túy không đổi API

Nguyên tắc 03

Giữ năm phân tích persona độc lập trước khi gom đồng thuận và mâu thuẫn

Nguyên tắc 04

Giải mâu thuẫn theo kịch bản xấu hợp lý và xuất mitigation có thể hành độ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.

Khởi động

Đầu vào, phạm vi, route

1 Đọc đề xuất Bắt đầu từ mô tả feature hoặc đề xuất thay đổi được đưa vào argument của lệnh.
2 Đọc code được chỉ định Khi có --files, đọc các đường dẫn code liên quan và grep vùng bị ảnh hưởng trước khi đánh giá thay đổi.

Xử lý

Agent / skill thực thi

3 Phân tích độc lập Architect, Security, Performance, UX và Devil’s Advocate lần lượt review đề xuất mà không ảnh hưởng lẫn nhau.
4 Tìm đồng thuận Thu thập các điểm mà toàn bộ persona, hoặc ít nhất bốn trên năm persona, cùng đồng ý.

Kiểm chứng

Gate, review, xác thực

5 Tìm mâu thuẫn Liệt kê các bất đồng đáng kể giữa kiến trúc, bảo mật, hiệu năng, UX và các giả định ẩn.
6 Cân nhắc đánh đổi Giải từng mâu thuẫn bằng cách so sánh kịch bản xấu hợp lý của mỗi lựa chọn, không chỉ happy path dự kiến.

Đóng

Báo cáo, bàn giao, artifact

7 Đưa verdict Trả GO, CAUTION hoặc STOP kèm đồng thuận, cách giải quyết mâu thuẫn, mức rủi ro, tín hiệu sớm, mitigation và khuyến nghị; sau đó chạy chain mode đã chọn nếu được yêu cầu.

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:predict <feature description or change proposal> [--files <glob>] [--chain reason|probe]

Đối số

<feature description or change proposal> Bắt buộc

Đề xuất cần review

Mô tả feature, refactor, hướng cạnh tranh hoặc đề xuất thiết kế bắt buộc cần stress-test trước khi triển khai. Nêu outcome, phạm vi, ràng buộc, giả định, bằng chứng và quyết định mà verdict cần mở khóa.

/ak:predict "Add hỗ trợ WebSocket cho thông báo real-time"

Option dùng chung

--files <glob>

Bằng chứng code giới hạn

Đọc code liên quan khớp glob trước khi persona debate. Giữ glob hẹp; tùy chọn này bám claim vào bằng chứng project hiện tại nhưng không chứng minh runtime behavior, giới hạn tải hoặc khả năng khai thác.

/ak:predict "Thay REST API bằng GraphQL" --files src/api/**/*.ts

--chain reason

Tinh chỉnh đánh đổi chủ quan

Sau verdict predict, chạy vòng generate, critique, synthesize và blind judge được hỗ trợ khi verdict CAUTION phụ thuộc vào đánh đổi thiết kế hoặc kiến trúc mang tính chủ quan. Đây là một phần của session predict, không phải skill độc lập.

/ak:predict "Chọn thư viện auth: Passport vs Better Auth" --chain reason

--chain probe

Chất vấn ràng buộc

Sau verdict predict, khai thác ràng buộc còn thiếu và giả định chưa nói rõ khi CAUTION hoặc STOP đến từ requirement chưa rõ. Cần bằng chứng mới hoặc mitigation khả thi trước khi đi qua một STOP trigger.

/ak:predict "Chuyển từ REST sang GraphQL" --chain probe

Mode / route nên dùng

--files <glob>

Đính kèm đường dẫn code đã biết để prediction đọc vùng bị ảnh hưởng trước khi persona debate.

Nghiên cứu:: code read
Review:: persona debate
Xác thực:: verdict

--chain reason

Sau verdict, chạy tinh chỉnh chủ quan khi CAUTION phụ thuộc vào đánh đổi về độ bóng kiến trúc hoặc tính nhất quán thiết kế.

Nghiên cứu:: refinement loop
Review:: blind judge
Xác thực:: convergence

--chain probe

Sau verdict, chất vấn ràng buộc còn thiếu và giả định chưa nói rõ khi CAUTION hoặc STOP đến từ requirement chưa đầy đủ.

Nghiên cứu:: requirement interrogation
Review:: assumption harvest
Xác thực:: saturation

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

Feature lớn Khuyến nghị

/ak:predict "Thêm hỗ trợ WebSocket cho thông báo thời gian thực"

Dùng khi:: Dùng trước khi triển khai feature lớn hoặc rủi ro cao.
Kết quả:: Skill chạy phân tích độc lập từ Architect, Security, Performance, UX và Devil’s Advocate, giải đồng thuận và mâu thuẫn, rồi trả report GO, CAUTION hoặc STOP có mức rủi ro, tín hiệu sớm, mitigation và khuyến nghị.

Đổi kiến trúc có đọc code

/ak:predict "Thay thế REST API bằng GraphQL" --files src/api/**/*.ts

Dùng khi:: Dùng khi đã biết file bị ảnh hưởng và muốn debate dựa trên code thật.
Kết quả:: Prediction đọc trước các đường dẫn code và vùng liên quan, rồi từng persona đánh giá đề xuất dựa trên implementation hiện có trước khi xuất mâu thuẫn, cách giải và verdict.

So sánh hướng kỹ thuật

/ak:predict "Chọn thư viện auth: Passport vs Better Auth" --chain reason

Dùng khi:: Dùng khi đánh giá các hướng kỹ thuật cạnh tranh có đánh đổi mang tính chủ quan.
Kết quả:: Sau verdict persona bình thường, --chain reason chạy vòng tinh chỉnh được hỗ trợ gồm generate, critique, synthesize và blind judge cho đến khi đánh đổi chủ quan hội tụ hoặc phần bất đồng còn lại được nêu rõ.

Stress-test giả định

/ak:predict "Chuyển từ REST sang GraphQL" --chain probe

Dùng khi:: Dùng khi stress-test giả định trong thiết kế đề xuất, nhất là khi ràng buộc còn thiếu có thể làm đổi câu trả lời.
Kết quả:: Sau verdict GO, CAUTION hoặc STOP, --chain probe khai thác ràng buộc còn thiếu và giả định chưa nói rõ để làm rõ đề xuất trước khi tiếp tục lập plan hoặc triển khai.

Phạm vi xử lý

Đọc đề xuất
Đọc code được chỉ định
Phân tích độc lập
Tìm đồng thuận
Tìm mâu thuẫn
Cân nhắc đánh đổi

Artifact tạo ra

Báo cáo dự đoán

Mẫu đường dẫn

Verdict: GO | CAUTION | STOP

Xuất phần đồng thuận, bảng mâu thuẫn và cách giải, tóm tắt rủi ro có cột mức độ, tín hiệu sớm và mitigation, kèm danh sách khuyến nghị đánh số.