Tóm tắt nhanh / Lệnh
Bộ Engineer
/ak:fix
Sửa lỗi theo nguyên nhân gốc cho error, test, lint, CI/CD, bug UI và vấn đề code với các cổng scout, chẩn đoán, xác minh và phòng ngừa.
Đóng khung ý định
Chọn mode
Scout trước
Chẩn đoán
Nguyên tắc 01
Scout và chẩn đoán trước mọi đề xuất fix.
Nguyên tắc 02
Triệu chứng không phải nguyên nhân gốc; có lẽ không phải bằng chứng.
Nguyên tắc 03
Sửa bề mặt nhỏ nhất đúng nguyên nhân và giữ non-goal đã nêu.
Nguyên tắc 04
Xác minh phải chứng minh triệu chứng gốc đã hết và blast radius an toàn.
Nguyên tắc 05
Các lần thử thất bại buộc đổi framing, không biện minh cho đoán mò thêm.
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:fix [issue] [--auto|--review|--quick|--parallel|--ultra] [--advice][issue] Bắt buộc Lỗi cần sửa
Bug, error, test thất bại, lỗi CI hoặc defect UI cụ thể. Nêu triệu chứng chính xác, repro tối thiểu, behavior mong đợi và thực tế, environment, ràng buộc, non-goal, tiêu chí chấp nhận và ranh giới quyền hạn cho Git, hệ thống bên ngoài, dữ liệu production và publication.
/ak:fix "POST /api/sessions returns 500 when expiresAt is absent. Reproduce with the focused API test, preserve the response contract, and do not commit or deploy." --review--auto Tự động
Mode mặc định cho lỗi đơn giản hoặc vừa phải. Cờ này bỏ các lần dừng thường lệ nhưng vẫn escalate blocker chưa xử lý, regression, quyết định quyền hạn và review dưới 9.5 hoặc có Critical finding.
/ak:fix đăng nhập chuyển hướng đến trang sai sau SSO --auto--review Người duyệt
Dừng để người dùng review ở mỗi bước chính. Phù hợp cho production, security-sensitive hoặc việc ảnh hưởng public contract.
/ak:fix production checkout timeout --review--quick Nhanh
Dùng cycle scout, chẩn đoán, sửa, xác minh và review ngắn cho lỗi type, lint, syntax hoặc defect trực tiếp trong một tệp. Bằng chứng root cause vẫn bắt buộc.
/ak:fix lỗi TypeScript trong UserTable --quick--parallel Song song
Chuyển các lỗi độc lập vào những workstream có ownership riêng. Issue phải độc lập, ownership tệp không chồng lấn và runtime delegation phải khả dụng cũng như được phép.
/ak:fix ba lỗi CI không liên quan --parallel--ultra Verifier ultra
Sau khi Steps 0-2 chạy một lần, gửi diagnosis đã xác nhận cho đúng năm ứng viên fix-plan chỉ đọc; verifier chọn một bản nguyên vẹn hoặc loại hết. Xung đột với --quick và --parallel.
/ak:fix flaky payment reconciliation bug --ultra--advice Giám sát cố vấn
Hỏi kongming tư vấn sau các phase, khi bị kẹt và trước quyết định rủi ro cao. Lời khuyên không thể sửa code, duyệt gate, bỏ qua verification hoặc mở rộng quyền hạn.
/ak:fix intermittent production incident --adviceChỉ các flag đổi artifact hoặc publish. Không phải toàn bộ option của skill.
--skip-journal Bỏ qua journal
Bỏ bước /ak:journal tự động ở cuối nhưng vẫn giữ các phần finalize còn lại.
Ví dụ
/ak:fix --skip-journal typo in validation message --auto Tự động mặc định
--review Có người duyệt
--quick Lỗi nhỏ
--parallel Nhiều lỗi độc lập
--ultra Chọn plan tốt nhất trong 5
Mỗi mục đối chiếu một lối tắt dễ mắc với cách làm đúng mà skill yêu cầu.
Lối tắt dễ mắc
Tôi thấy lỗi rồi, sửa luôn.
Cách làm đúng
Thấy triệu chứng chưa phải phân tích nguyên nhân gốc. Scout trước.
Lối tắt dễ mắc
Sửa nhanh trước, điều tra sau.
Cách làm đúng
Sau này thường không đến. Chẩn đoán đúng ngay bây giờ.
Lối tắt dễ mắc
Test pass là xong.
Cách làm đúng
Không có phòng ngừa và quét side-effect thì cùng lớp lỗi có thể tái diễn hoặc gây regression nơi khác.
Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.
/ak:fix--autođăng nhập bị chuyển hướng đến sai trang sau SSO
/ak:fix--quickLỗi TypeScript trong UserTable
/ak:fix--reviewproduction timeout thanh toán
/ak:fix--ultrarace condition trong websocket reconnect
/ak:fix--parallelba lỗi CI không liên quan