Tóm tắt nhanh:
ak-handoffghi một file Markdown 9 mục cho agent làm tiếp: mục tiêu, giới hạn, trạng thái repo, quyết định, kiểm tra đã chạy, rủi ro và bước an toàn đầu tiên. Mặc định nó chỉ ghi file, bạn dán dòng nhắc vào phiên mới; thêm--dispatchthì nó giao file cho runtime bạn chọn quaak-orchestrate. Nó không sửa code và không viết báo cáo tiến độ cho người.
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 phải đổi phiên, đổi model hoặc đổi runtime giữa chừng mà việc còn dở, hoặc muốn một agent khác làm tiếp ngay. Không cần khi bạn chỉ muốn xem dự án đang ở đâu (branch, worktree, plan): việc đó là của ak-watzup.
flowchart LR
A["Việc đang dở"] --> B["ak-handoff"]
B --> C["File handoff 9 mục"]
C --> D["Phiên mới đọc file, kiểm repo, làm tiếp"]
B -->|"--dispatch"| E["ak-orchestrate giao cho runtime bạn chọn"]Nó giữ 4 nguyên tắc:
| Nguyên tắc | Câu hỏi | Ví dụ |
|---|---|---|
| Hợp đồng làm tiếp | Agent mới cần biết gì để làm tiếp mà không phải đoán lại? | 9 mục cố định, đúng thứ tự: mục tiêu và tiến độ (Mission and current status), phạm vi và giới hạn (Scope and guardrails), trạng thái repo (Current state), quyết định và lý do (Decisions and rationale), việc đã làm (Work performed), kiểm tra (Verification), rủi ro và vướng mắc (Open risks and blockers), bước tiếp theo (Exact next actions), nguồn tham chiếu (Source pointers). Mục Exact next actions mở đầu bằng **First safe step**, ví dụ "đọc src/auth/callback.ts và test của nó". |
| Không bịa khi thiếu | Phiên này không có thông tin cho một mục thì sao? | Chưa chạy test nào thì mục Verification ghi đúng câu Not captured in this session. Mục không bị xoá, không ghi "TBD". Agent mới thấy câu này thì biết phải tự đi tìm bằng chứng. |
| Che secret | Token, mật khẩu trong lệnh đã chạy có lọt vào file không? | Một JWT trong output được thay bằng [REDACTED:jwt], chuỗi kết nối DB có mật khẩu thành [REDACTED:db-url]. Cuối mục Work performed chỉ ghi số lần đã che, không ghi giá trị. |
| Người đọc là agent | File này viết cho ai? | Cho một agent AI sắp làm tiếp đúng việc này. Muốn một báo cáo cho người về tình hình dự án (branch, worktree, plan) thì dùng ak-watzup. |
File chỉ là ảnh chụp lúc ghi: repo có thể đổi sau đó, nên agent mới phải đối chiếu mục Current state với repo trước khi làm. Với --dispatch, bạn phải tự chọn --agent, nó không chọn hay tự đổi runtime giúp bạn.
Prompt mẫu khi đổi phiên giữa chừng:
/ak-handoff "sửa lỗi callback OAuth trả về 500 trên <tên app>"| Cờ | Để làm gì | Từ ak |
|---|---|---|
--output | Ghi file vào đường dẫn bạn chọn | 2.10.0 |
--include-diff | Kèm số dòng đổi mỗi file và tối đa 200 dòng diff đầu | 2.10.0 |
--include-status | Kèm ảnh chụp git status --short | 2.10.0 |
--force | Cho phép ghi đè file handoff đã có | 2.10.0 |
--dispatch --agent <id> | Ghi handoff rồi giao cho runtime bạn chọn | 2.17.0 |
--handoff | Giao một file handoff đã có, không chụp mới | 2.17.0 |
--cwd | Chọn thư mục gốc cho job được giao | 2.17.0 |
--model | Chọn model cho runtime dạng CLI | 2.17.0 |
--yes | Đồng ý trước cho job được ghi | 2.17.0 |
--task | Cách viết khác của đoạn trọng tâm | 2.17.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 5 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-handoff: ghi lại việc dở để agent mới làm tiếp" 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-handoff". 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-handoff
