Tóm tắt nhanh:
ak-cooklàm một việc đã rõ, hoặc chạy một plan đã duyệt, từ đọc code tới sửa, kiểm tra và review. Xong thì bạn chuyển sangak-testrồiak-ship. Nó không đi tìm nguyên nhân bug: việc đó là củaak-fix.
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 đã biết chính xác cần làm gì, đã có plan từ ak-plan, hoặc cần refactor mà giữ nguyên hành vi. Không cần khi gặp bug, lỗi test hay lỗi CI chưa rõ nguyên nhân (chạy ak-fix), hoặc khi chưa rõ nên làm cách nào (chạy ak-brainstorm).
flowchart LR
A["ak-brainstorm hoặc ak-plan"] --> B["ak-cook"]
B --> C["Code đã kiểm tra và review"]
C --> D["ak-test"]
D --> E["ak-ship"]
B --> F["Dừng: cần quyết định của bạn"]Bốn khái niệm quyết định cách nó chạy:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Phạm vi được phép | Cook được tự làm tới đâu mà không cần hỏi lại bạn? | "Sửa trong src/billing, được chạy test, không commit" thì nó tự sửa cả lỗi hồi quy do chính nó gây ra, nhưng dừng trước khi commit hay xoá dữ liệu. |
| Chế độ chạy | Lần chạy này bỏ bước nào và dừng ở đâu? | Không cờ thì chạy thẳng. --interactive dừng 4 lần chờ bạn duyệt. --fast bỏ bước tìm hiểu. Cờ thắng mọi tín hiệu khác trong câu lệnh. |
| Kiểm tra theo rủi ro | Phải chạy những kiểm tra nào thì mới được gọi là xong? | Sửa một hàm tính giá: chạy test của hàm đó trước, rồi tới chỗ gọi nó, rồi type, lint hoặc build tuỳ mức rủi ro. Không tắt kiểm tra đang đỏ để cho qua. |
| Plan nằm trong file | Tiến độ của plan được ghi ở đâu? | Trong plan.md và các file phase-NN-*.md của bạn. Cook chỉ đánh dấu xong mục nào có bằng chứng, mục chưa có bằng chứng thì để nguyên. |
Trước khi sửa, nó chốt 4 điều: kết quả, ràng buộc, ngoài phạm vi, nghiệm thu. Có plan được duyệt thì nó dùng lại 4 điều trong đó. Nó chỉ commit khi bạn đã cho phép, nên hãy ghi rõ trong prompt.
Prompt mẫu cho một tính năng đã rõ:
/ak-cook Thêm nút "Xuất CSV" cho bảng đơn hàng trong app <tên app>.
Kết quả: bấm nút thì tải về file CSV đúng các cột đang hiện.
Ràng buộc: không đổi API danh sách đơn hàng.
Không làm: xuất Excel, lọc theo ngày.
Xong khi: có test cho hàm tạo CSV và test cũ vẫn pass. Không commit.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--interactive | Dừng chờ bạn duyệt ở các bước lớn | 1.0.0 |
--fast | Bỏ bước tìm hiểu, làm nhanh | 1.0.0 |
--parallel | Chia việc độc lập cho nhiều agent | 1.0.0 |
--auto | Chạy hết các phase không dừng duyệt | 1.0.0 |
--no-test | Không chạy test, báo rõ chỗ hổng | 1.0.0 |
--tdd | Viết test cho hành vi cũ trước khi refactor | 1.0.0 |
--advice | Cố vấn model mạnh hơn ở mốc quan trọng | 2.5.0 |
--yagni | Cắt phần không cần cho kết quả | 2.8.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-cook: biến yêu cầu đã rõ thành code đã kiểm tra" 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-cook". 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-cook
