Tóm tắt nhanh:
ak-shipđưa một nhánh đã xong qua test, review, version, changelog, commit, push và tạo PR chỉ bằng một lệnh. Thêm--mergethì nó giao choak-review-prđể đi tới merge, xong thì chuyển choak-journal. Nó không tự gỡ lỗi ngoài quyền sửa như thiếu credential hay conflict không tự giải được: gặp là dừng và đưa bằng chứng.
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 có một nhánh tính năng đã làm xong và cần PR. Đừng chạy khi đang đứng trên nhánh đích: nó huỷ ngay.
flowchart LR
A["ak-code-review"] --> B["ak-ship"]
B --> C["URL PR"]
B --> D["--merge: ak-review-pr merge, CI xanh"]
B --> E["Dừng: lỗi ngoài quyền sửa, conflict"]
C --> F["ak-journal"]Mỗi lần ship, nó chốt 4 điều:
| Điều | Câu hỏi | Ví dụ |
|---|---|---|
| Chế độ ship | PR đi vào nhánh nào, chạy những bước nào? | official nhắm nhánh mặc định, chạy đủ bước docs. beta nhắm nhánh phát triển, bỏ bước docs |
| Cổng chặn | Khi nào tự sửa, khi nào dừng? | Test hỏng do code của nhánh: sửa rồi chạy lại. Thiếu credential: dừng, đưa bằng chứng |
| Phạm vi commit | File nào được đưa vào commit? | Chỉ file thuộc việc đang ship, cộng version, changelog, plan, docs đi kèm |
| Ai merge PR | Dừng ở PR hay đi tới merge? | Mặc định dừng ở URL PR. Có --merge thì giao cho ak-review-pr |
Không ghi chế độ thì nó đoán theo tên nhánh hiện tại (feature/* là official, dev/* là beta), không rõ thì hỏi bạn. Repo khai báo có bên merge theo lô thì ship dừng sau khi tạo PR, kể cả khi có --merge.
Prompt mẫu cho ship lên nhánh chính:
/ak-ship official| Cờ | Để làm gì | Từ ak |
|---|---|---|
--both | Ship lên beta rồi tới stable trong một lần chạy | 2.13.0 |
--advice | Có kongming giám sát đường ship tới PR | 2.13.0 |
--merge | Đi tiếp từ PR tới merge có review | 2.13.0 |
--skip-tests | Bỏ bước chạy test | 1.0.0 |
--skip-review | Bỏ bước review cục bộ trước khi lên PR | 1.0.0 |
--skip-journal | Bỏ bước viết journal | 1.0.0 |
--skip-docs | Bỏ bước cập nhật docs | 1.0.0 |
--social | Đăng build-in-public sau khi ship | 2.12.0 |
--yes-post | Đăng thật, không chỉ chạy thử | 2.12.0 |
--yes-post-private | Xác nhận thứ hai khi repo là private | 2.12.0 |
--dry-run | Xem trước, không làm gì | 1.0.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-ship: đưa nhánh đã xong qua test, review tới PR" 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-ship". 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-ship
