Tóm tắt nhanh:
ak-worktreemở một thư mục làm việc riêng, có branch riêng, cho mỗi việc mà không đụng thư mục bạn đang làm dở. Nó tự đặt tên branch, chọn branch gốc và chỗ đặt worktree, rồi chuyển choak-cookhoặcak-fix. Nó không viết code.
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 đang làm dở một việc mà cần bắt đầu việc khác, không muốn stash hay đổi branch. Cũng dùng khi máy có nhiều worktree và bạn muốn xem tình trạng, dọn cái đã xong.
flowchart LR
A["Việc mới cần tách riêng"] --> B["ak-worktree"]
B --> C["Worktree mới hoặc dùng lại cái có sẵn"]
C --> D["ak-cook"]
C --> E["ak-fix"]
B --> F["Xem tình trạng, dọn worktree cũ rồi dừng"]Cốt lõi của skill là 4 câu hỏi:
| Phần | Câu hỏi | Ví dụ |
|---|---|---|
| Tên branch | Branch mới tên gì? | "sửa lỗi timeout khi upload" thành fix/upload-timeout |
| Branch gốc | Branch mới tách ra từ đâu? | Repo có dev thì tách từ dev, chỉ có main thì tách từ main |
| Chỗ đặt worktree | Thư mục worktree nằm ở đâu? | Repo ~/code/shop thì worktree là ~/code/worktrees/shop-upload-timeout |
| Dọn an toàn | Xoá worktree có làm mất gì không? | Còn 3 file chưa commit thì nó báo và chờ bạn đồng ý rồi mới xoá |
Điều cần nhớ nhất: commit hoặc push trước khi dọn. Skill có kiểm và hỏi, nhưng xoá rồi thì thay đổi chưa commit trong thư mục đó không lấy lại được.
Prompt mẫu cho việc mới song song:
/ak-worktree Sửa lỗi upload ảnh bị timeout ở app <tên app>| Cờ | Để làm gì | Từ ak |
|---|---|---|
--prefix, --no-prefix | Chọn tiền tố branch, hoặc bỏ hẳn tiền tố | 1.0.0 |
--base | Chỉ định branch gốc | 1.0.0 |
--checkout-submodules | Kéo submodule về trong worktree mới | 1.0.0 |
--worktree-root | Chọn thư mục chứa worktree cho lần này | 1.0.0 |
--dry-run | Xem trước, không đổi gì | 1.0.0 |
--json | Kết quả dạng JSON | 1.0.0 |
Đầu vào chính không phải cờ: bạn gõ mô tả việc, hoặc tên project rồi mô tả việc khi repo có nhiều project. AI tự chọn phần lớn cờ.
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ì), 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-worktree: mở worktree riêng cho mỗi 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 "ak-worktree". 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-worktree
