Tóm tắt nhanh:
ak-goal-warmupchuẩn bị cho một việc chạy dài nhiều giờ: chốt hợp đồng kết quả với bạn, lập plan bám hợp đồng, soát rủi ro và kiểm mọi phase xem còn thiếu công cụ, quyền hay credential. Nó kết thúc ở Ready, Blocked hoặc Decision required, và khi Ready thì đưa bạn gói bàn giao để tự dán vào Codex/goalhoặc một phiên Claude chạy dài. Nó không bao giờ tự khởi động/goal.
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 sắp giao cho agent một việc chạy nhiều giờ, sai hướng giữa chừng sẽ tốn cả đêm, hoặc việc có deploy, credential, dịch vụ ngoài và bạn muốn biết trước còn thiếu gì. Việc nhỏ chỉ chạy cục bộ thì dùng --fast. Không cần khi bạn muốn agent làm và khởi động luôn: skill này chỉ chuẩn bị, bạn vẫn tự dán gói vào /goal.
flowchart LR
A["Ý tưởng việc chạy dài"] --> B["ak-advise, nếu cần"]
A --> C["ak-goal-warmup"]
B --> C
C --> D["Ready: gói bàn giao"]
C --> E["Blocked: việc cần bổ sung"]
C --> F["Decision required: bạn chọn"]
D --> G["Bạn tự dán vào Codex /goal hoặc phiên Claude dài"]Nó dựa trên 4 khái niệm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Hợp đồng kết quả | Xong thì trông thế nào, và cái gì tuyệt đối không được đổi giữa chừng? | Kết quả: API mới chạy song song API cũ. Trong phạm vi: 12 endpoint. Ngoài phạm vi: đổi giao diện. Nghiệm thu: test e2e của client cũ vẫn pass. Ràng buộc: không thêm dịch vụ trả phí. Thay thế được phép: không có. Người quyết định: bạn. |
| Bốn loại phát hiện khi review | Một góp ý từ review được phép sửa plan tới đâu? | "Đổi tên hàm cho dễ đọc" là mitigation-within-contract, được sửa plan. "Bỏ e2e cho nhanh" khi e2e là nghiệm thu là outcome-change-request, không được sửa, phải hỏi bạn. |
| Bảng kiểm trước khi chạy | Phase nào sẽ kẹt giữa đêm vì thiếu công cụ, quyền, hay credential? | Phase deploy cần biến CLOUD_DEPLOY_TOKEN: trạng thái missing, chặn, việc cần làm là đặt biến đó trong env hoặc kho secret. |
| Ba trạng thái kết thúc | Giờ bạn làm gì tiếp? | Ready thì bạn dán gói vào /goal. Blocked thì bạn bổ sung đúng các mục được liệt kê rồi chạy lại. Decision required thì bạn chọn một phương án. |
Sau khi bạn duyệt, hợp đồng bị khoá: plan, review và bước kiểm chỉ được thêm rủi ro, bằng chứng, câu hỏi, không được đổi kết quả. Mọi đề xuất đổi kết quả đi qua Decision required và bạn phải duyệt lại.
Prompt mẫu cho việc lớn nhiều phase:
/ak-goal-warmup "Chuyển API của <tên dự án> từ REST sang tRPC.
Kết quả: mọi endpoint có bản tRPC, client cũ vẫn gọi REST được.
Ràng buộc: không đổi schema DB. Không làm: đổi giao diện.
Nghiệm thu: test hiện có pass, có test mới cho từng router tRPC."| Cờ | Để làm gì | Từ ak |
|---|---|---|
--fast | Chuẩn bị nhanh cho việc nhỏ chạy cục bộ | 2.5.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 4 tình huống kèm prompt, giải thích cờ --fast (dùng khi, không cần khi, nhận lại gì), 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-goal-warmup: chuẩn bị kỹ trước khi chạy /goal dài" 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-goal-warmup". 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-goal-warmup
