Tóm tắt nhanh:
ak-fixnhận một lỗi cụ thể như bug, test đỏ, lỗi type, lint hay CI đỏ, chứng minh nguyên nhân gốc trước, sửa đúng chỗ rồi chạy lại đúng lệnh từng hỏng để chứng minh đã hết. Xong thì chuyển choak-test. Nó không sửa theo triệu chứng, không đoán mò sau 3 lần hỏng, và không tự commit hay push khi bạn chưa cho phép.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn có một lỗi thật: bug có triệu chứng, test đỏ, lỗi type hoặc lint, log báo lỗi, CI đỏ. Không cần khi bạn chỉ có ý tưởng hay tính năng mới: lúc đó bắt đầu bằng ak-brainstorm.
flowchart LR
A["Lỗi cụ thể: bug, test đỏ, CI đỏ"] --> B["ak-fix"]
B --> C["Nguyên nhân + bản sửa + bằng chứng trước/sau"]
C --> D["ak-test"]
B --> E["Hỏng 3 lần: dừng, bàn kiến trúc với bạn"]
B --> F["Loại cả 5 bản với --ultra: dừng, nói lý do"]Nó luôn giữ 4 nguyên tắc:
| Nguyên tắc | Câu hỏi | Ví dụ |
|---|---|---|
| Nguyên nhân trước, sửa sau | Đã trả lời đủ 6 điều chưa: triệu chứng nguyên văn, cách tái hiện, kỳ vọng so với thực tế, nguyên nhân gốc chỉ tới file và dòng, vì sao giờ mới lộ, những chỗ khác bị ảnh hưởng? | "Người dùng bị đăng xuất" là triệu chứng. "Hàm làm mới phiên so sánh giờ theo múi giờ máy chủ ở src/auth/session.ts:42, lộ ra từ lần đổi server tuần trước" là nguyên nhân. |
| Chọn đường theo độ khó | Sau khi chẩn đoán, lỗi này rõ và nằm một chỗ, lan nhiều file, hay đụng tới kiến trúc? | Lỗi type ở một file đi đường nhanh (quick). Lỗi lan 2 tới 5 file đi đường chuẩn (standard). Rò bộ nhớ, deadlock, lỗ hổng bảo mật đi đường sâu (deep): tìm hiểu thêm, gọi ak-brainstorm so sánh cách sửa, viết plan rồi mới sửa. |
| Chứng minh không có tác dụng phụ | Ngoài chỗ vừa sửa, có gì khác bị vỡ không? | Chạy lại đúng lệnh từng đỏ, thêm test hồi quy đỏ khi bỏ bản sửa, chạy test của các chỗ gọi tới hàm đã đổi, kiểm tra chữ ký hàm, schema, API, biến môi trường không đổi. Lỗi type, lint thì chính trình kiểm tra là bằng chứng. |
| Giới hạn 3 lần | Sửa mãi không được thì sao? | Kiểm chứng hỏng thì quay lại chẩn đoán. Hỏng tới lần thứ ba thì dừng, đưa bằng chứng ra và cùng bạn xem lại kiến trúc, không thử tiếp kiểu đoán mò. |
Bản sửa làm hỏng thứ khác trong phạm vi được giao thì nó tự sửa tiếp. Nó chỉ hỏi bạn khi thiếu một quyết định quan trọng, khi phải đổi hợp đồng đã chốt, hoặc khi cần làm việc phá huỷ chưa được phép.
Prompt mẫu cho bug chưa rõ chỗ hỏng:
/ak-fix Trang <tên trang> thỉnh thoảng trả về dữ liệu của tài khoản khác.
Tái hiện: đăng nhập 2 tài khoản ở 2 tab, tải lại liên tục tab thứ hai.
Ràng buộc: không đổi format response của API <tên API>.
Xong khi: có test tái hiện, test pass sau khi sửa, test cũ vẫn xanh.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--auto | Tự đi hết từ chẩn đoán, sửa tới kiểm chứng, chỉ hỏi khi cần | 1.0.0 |
--review | Dừng chờ bạn duyệt ở mỗi bước lớn, kể cả review | 1.0.0 |
--quick | Đường ngắn cho lỗi rõ ràng, nằm một chỗ | 1.0.0 |
--parallel | Sửa song song nhiều lỗi độc lập | 1.0.0 |
--ultra | 5 bản kế hoạch sửa, chọn bản tốt nhất | 2.13.0 |
--advice | Model mạnh hơn góp ý ở mốc quan trọng | 2.5.0 |
--skip-journal | Bỏ bước ghi journal tự động | 2.9.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 6 tình huống kèm prompt, giải thích từng cờ (dùng khi, không cần khi, nhận lại gì, đi kèm cờ nào), lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-fix: tìm đúng nguyên nhân lỗi rồi sửa tận gốc" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-fix". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-fix
