Tóm tắt nhanh / Lệnh
Bộ Engineer
/ak:ship
Đưa một nhánh tính năng đã hoàn tất qua nhận diện đích, liên kết issue, merge, test, review, tăng version, changelog, journal/docs, commit, push, tạo PR, tùy chọn merge đã review và đăng social khi người dùng bật rõ ràng.
Tiền kiểm và mode
Liên kết issue
Merge nhánh đích
Chạy test
Nguyên tắc 01
Tự nhận diện quy ước dự án thay vì hỏi sớm
Nguyên tắc 02
Không bỏ test trừ khi người dùng truyền --skip-tests
Nguyên tắc 03
Chỉ push bình thường; không force-push hoặc vượt branch protection
Nguyên tắc 04
Ghi trung thực Not run/Unavailable thay vì bịa câu chuyện trong PR
Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.
Khởi động
Đầu vào, phạm vi, route
Xử lý
Agent / skill thực thi
Kiểm chứng
Gate, review, xác thực
Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.
Cú pháp
/ak:ship [official|stable|main|beta|dev|next] [--both] [--advice] [--merge] [--skip-tests] [--skip-review] [--skip-journal] [--skip-docs] [--social] [--yes-post] [--yes-post-private] [--dry-run][official|stable|main|beta|dev|next] Mode phát hành
Token mode tùy chọn. official, stable và main được chuẩn hóa thành luồng official và nhắm tới nhánh mặc định đã phát hiện; beta, dev và next được chuẩn hóa thành luồng beta và nhắm tới nhánh phát triển đã phát hiện. Chỉ bỏ token này khi tên nhánh có thể chọn mode an toàn.
/ak:ship official--both Ship cả hai đích
Chạy stage beta trước, rồi đến stage stable có gate. Cờ này ưu tiên hơn mọi token mode vị trí và không bao giờ bỏ qua branch protection.
/ak:ship --both --merge--advice Hỏi Kongming
Thêm các checkpoint Kongming chỉ tư vấn vào luồng ship-to-PR cục bộ. Lời khuyên không thay thế test, review hoặc quyền quyết định của agent chính.
/ak:ship beta --advice--merge Merge có review
Sau khi tạo PR, giao cho ak:review-pr xử lý fix, reply, merge và đưa CI sau merge về xanh. Nếu thiếu cờ này, ak:ship không merge PR.
/ak:ship official --merge--skip-tests Bỏ test
Bỏ gate test chỉ khi đã có bằng chứng tương đương; PR phải ghi trung thực bằng chứng cho việc bỏ qua.
/ak:ship --skip-tests--skip-review Bỏ review local
Bỏ bước review trước khi tạo PR. Cờ này không phê duyệt PR và không bỏ luồng ak:review-pr hạ nguồn khi có --merge.
/ak:ship --skip-review--skip-journal Bỏ journal và social
Bỏ technical journal chạy nền và tắt toàn bộ bước social; các gate code và bằng chứng PR vẫn giữ nguyên.
/ak:ship --skip-journal--skip-docs Bỏ cập nhật docs
Bỏ cập nhật docs trong mode official. Mode beta tự động bỏ bước docs đó.
/ak:ship official --skip-docs--social Nháp social
Sau gate PR xanh bắt buộc, soạn bài build-in-public từ bối cảnh PR, issue và plan. Nếu thiếu --yes-post, chỉ render nội dung và không gọi API.
/ak:ship --social--yes-post Đăng social
Cho phép --social đăng thật thay vì chỉ render. Cờ này không có tác dụng đăng nếu thiếu --social.
/ak:ship --social --yes-post--yes-post-private Xác nhận đăng repo private
Xác nhận rõ lần hai trước khi đăng social về repository private. Cờ này cần --social và --yes-post.
/ak:ship --social --yes-post --yes-post-private--dry-run Chỉ xem trước
Đọc trạng thái tiền kiểm và in pipeline dự kiến, không ủy quyền, không review-merge, không đăng social, không mutate và không mô phỏng stable stage cho --both.
/ak:ship --dry-runVí dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.
/ak:ship/ak:shipbeta--advice--merge
/ak:ship--both--merge
/ak:shipofficial--social