Khi bạn giao cho agent việc "thêm tìm kiếm theo tiêu đề", câu "add search; tests pass" vẫn bỏ trống nhiều điều. Tìm trong trường nào? Truy vấn có còn sau khi tải lại không? Người dùng nhìn thấy gì khi việc đã xong? Một bản kế hoạch tốt trả lời các câu đó trước khi agent thực hiện.
Ghi chú: bản beta hiện tại của AgentKit (từ 3.0.0-beta.35, 21/10/2026) đã đổi format tên skill từ ak:<tên> sang ak-<tên>, nên lệnh trong bài đã cập nhật theo tên mới: Claude Code gõ /ak-plan, Codex gõ $ak-plan. Nếu bạn còn dùng bản cũ hơn, đổi ak- thành ak: là ra lệnh tương ứng.
ak-plan lập kế hoạch triển khai, ghi phạm vi, tiêu chí kiểm chứng, giả định và các bước cần làm, theo tài liệu Plan. ak-cook thực hiện phần đã được cấp quyền, đọc repo thật và chạy các kiểm tra phù hợp, theo tài liệu Cook. ak-plan không thay đổi mã sản phẩm. ak-cook mới tạo thay đổi và kiểm chứng kết quả.
Đây là cách hiểu về hai skill, không phải chế độ runtime. Xem thêm bài phân biệt chế độ runtime với AgentKit skill ak-plan để tránh trộn hai khái niệm.
Ví dụ: thêm tìm kiếm theo tiêu đề
Yêu cầu làm việc trong bài là: "Thêm ô tìm kiếm theo tiêu đề. Dùng tham số q. Khi tải lại trang, giữ nguyên q và hiển thị các mục có tiêu đề phù hợp."
Plan sẽ làm rõ ít nhất ba điều:
- Phạm vi là tìm trong tiêu đề của danh sách hiện có, không mở rộng sang nội dung thân bài.
qlà trạng thái truy vấn quan sát được trong URL và phải tồn tại sau khi tải lại.- Tiêu chí đạt là người dùng nhập từ khóa, thấy kết quả đúng, tải lại trang và vẫn thấy đúng kết quả. Kiểm tra liên quan cũng phải chạy thành công.
Cook không xem plan.md là bằng chứng rằng mã nguồn đã được kiểm tra. Cook phải đọc đường dẫn thật, cách ứng dụng đang đọc truy vấn, bộ kiểm tra hiện có và quy ước của repo. Nếu kế hoạch đoán sai đường dẫn hoặc thiếu một ràng buộc, Cook phải điều chỉnh trong phạm vi được ủy quyền hoặc dừng để hỏi.
| Plan | Cook |
|---|---|
| Lập kế hoạch triển khai và tiêu chí đạt | Thực hiện phần được ủy quyền và kiểm chứng kết quả |
Trả về bản tóm tắt trong plan.md | Trả về thay đổi mã, kết quả kiểm tra và vấn đề còn lại nếu có |
| Làm rõ phạm vi trước khi viết mã | Đọc repo thật trước khi chọn cách sửa |
plan.md là bản tóm tắt. Đường dẫn các giai đoạn thực tế có thể khác nhau. Trước khi gọi skill, cài Engineer Kit cho Claude Code và mở đúng dự án cần sửa. Sau đó, lệnh minh họa có thể có dạng:
/ak-plan Thêm tìm kiếm theo tiêu đề, giữ q sau khi tải lại
/ak-cook ./plans/search/plan.mdĐường dẫn ./plans/search/plan.md chỉ là ví dụ. Hãy thay bằng đường dẫn thật mà Plan trả về. Gõ các lệnh có dấu / trong ô nhập Claude Code, không chạy trong shell. Với việc ngắn, rõ, rủi ro thấp và đã đủ tiêu chí, người dùng có thể đi thẳng đến Cook.
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 "Từ ak-plan đến ak-cook: bàn giao để agent làm đúng việ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 "agentkit-plan-cook-ban-giao". 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
- 18/10/2026
- Giấy phép
- Subscriber-only; redistribution prohibited
- Slug
- agentkit-plan-cook-ban-giao
