Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:vibe

Chạy pipeline phát triển tự động

Chạy pipeline phát triển tự động từ issue hoặc yêu cầu feature qua worktree, plan, triển khai, review, PR, label sẵn sàng và tùy chọn merge/đưa CI về xanh.

01

Phân tích yêu cầu

02

Tạo worktree

03

Gate kế hoạch

04

Đồng bộ issue

Nguyên tắc 01

Một lệnh sở hữu pipeline, nhưng từng skill bên dưới vẫn giữ gate riêng.

Nguyên tắc 02

GitHub issue là nguồn sự thật; không tạo trùng issue đã có.

Nguyên tắc 03

Công việc diễn ra trong worktree tách biệt, không làm trực tiếp trên branch nền được bảo vệ.

Nguyên tắc 04

Route bugfix đi qua ak:fix; route feature đi qua ak:cook.

Nguyên tắc 05

Label ready nghĩa là đã review, đã fix, đã reply và CI/blocker đã được xử lý có trách nhiệm.

Bản đồ thực thi

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.

01

Khởi động

Đầu vào, phạm vi, route

  1. 1 Phân tích yêu cầu Tách flag, quyết định mode stable/beta/both, đọc GitHub issue hoặc yêu cầu tự nhiên, rồi trích outcome, acceptance, scope, ràng buộc và blocker.
  2. 2 Tạo worktree Dùng ak:worktree để tạo hoặc tái sử dụng branch/worktree tách biệt, sạch và khớp yêu cầu.
  3. 3 Gate kế hoạch Tái sử dụng plan hợp lệ hoặc chạy ak:plan --tdd, sau đó validate, red-team và quét nhất quán toàn plan trước triển khai.
02

Xử lý

Agent / skill thực thi

  1. 4 Đồng bộ issue Tạo hoặc cập nhật label GitHub, body/comment issue, branch, route, link plan, ship mode, acceptance criteria và liên kết plan index.
  2. 5 Triển khai theo route Gắn label in progress, rồi chạy ak:fix --auto cho bug hoặc ak:cook --tdd --auto cho feature với plan đã validate.
  3. 6 Review local Chạy ak:code-review --pending và sửa các finding Critical/Important trước khi ship.
03

Kiểm chứng

Gate, review, xác thực

  1. 7 Mở PR Ship PR beta hoặc official theo mode; với both mode, ship beta trước và stable phải chờ beta merge cùng CI xanh.
  2. 8 Review PR Chạy ak:review-pr với fix và reply, xử lý finding hành động được, và yêu cầu check xanh hoàn tất trừ khi có blocker ngoài đã ghi rõ.
  3. 9 Đánh dấu sẵn sàng Gắn label ready-to-ship beta hoặc stable cho issue nguồn và PR, rồi gỡ label ready-to-cook và in-progress cũ.
04

Đóng

Báo cáo, bàn giao, artifact

  1. 10 Merge và đưa CI xanh Khi ship mode yêu cầu, merge theo luật GitHub, theo dõi CI trên branch đích, tạo vòng fix tiếp theo cho lỗi xác định được và đóng plan index.

Cú pháp, đối số, subcommand

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:vibe [--ship] [--beta] [--both] [--advice] <github-issue-url | feature request>

Đối số

<github-issue-url | feature request> Bắt buộc

Issue hoặc yêu cầu

Cung cấp GitHub issue làm nguồn sự thật, hoặc một yêu cầu feature cụ thể sẽ trở thành issue sau khi plan được validate; cần đủ outcome, phạm vi, ràng buộc và bối cảnh nghiệm thu để triển khai.

/ak:vibe https://github.com/acme/app/issues/42

Option dùng chung

--ship

Merge và đưa CI xanh

Sau khi PR được review, sửa, reply và các check bắt buộc xanh, cho phép merge PR theo luật repository rồi theo dõi hoặc sửa CI trên branch đích đến khi thành công hoặc có blocker ngoài đã ghi rõ.

/ak:vibe --ship fix flaky checkout redirect
--beta

Đích beta

Ship tới đích beta/dev qua ak:ship beta và kết thúc bằng label ready-to-ship beta; nếu không có --ship thì dừng ở trạng thái PR đã review và sẵn sàng.

/ak:vibe --beta https://github.com/acme/app/issues/42
--both

Beta rồi stable

Chạy trọn stage beta trước, gồm merge và CI xanh, rồi mới chạy stage stable; flag này ngầm bật --ship và ưu tiên hơn --beta khi cả hai cùng xuất hiện.

/ak:vibe --both https://github.com/acme/app/issues/42
--advice

Giám sát Kongming

Thêm các checkpoint Kongming chỉ tư vấn sau các phase lớn, khi bị kẹt, trước quyết định rủi ro cao và sau khi CI của PR xanh; kết hợp được với mọi ship mode và không bao giờ bỏ qua gate.

/ak:vibe --advice --ship https://github.com/acme/app/issues/42

Mode / route nên dùng

default

Sẵn sàng PR stable

Nghiên cứu:
Full plan gates
Review:
Required
Xác thực:
Review and checks
--beta

Sẵn sàng PR beta

Nghiên cứu:
Full plan gates
Review:
Required
Xác thực:
Beta review and checks
--ship

Merge và đưa CI xanh

Nghiên cứu:
Full pipeline
Review:
Required
Xác thực:
Post-merge CI loop
--both

Beta rồi stable

Nghiên cứu:
Two-stage pipeline
Review:
Per stage
Xác thực:
Beta CI before stable

Tính năng đặc biệt

Issue là nguồn sự thật

Issue URL phải khớp repo hiện tại; nếu không, dừng và yêu cầu repo/worktree đúng.

Ship hai stage

Both mode merge beta và đưa CI xanh trước stable; nếu beta còn blocked thì bỏ qua stable.

Tư vấn chỉ là tư vấn

Kongming chỉ đưa lời khuyên, không viết code; agent chính vẫn chịu trách nhiệm quyết định, edit và gate.

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Đưa issue tới trạng thái sẵn PR Khuyến nghị
/ak:vibe https://github.com/acme/app/issues/42
Dùng khi:
Một GitHub issue cần được lập plan, triển khai, review và gắn ready nhưng chưa tự merge.
Kết quả:
Tạo worktree tách biệt, validate gate plan, ship PR đã review và gắn ready-to-ship stable.
Tự merge có kiểm CI
/ak:vibe --ship sửa redirect checkout flaky
Dùng khi:
Yêu cầu cần chạy tiếp qua merge và đưa CI branch đích về xanh.
Kết quả:
Tạo hoặc cập nhật issue, triển khai qua route đúng, merge và lặp fix lỗi CI xác định được.
Đưa PR beta tới trạng thái ready
/ak:vibe --beta https://github.com/acme/app/issues/42
Dùng khi:
Yêu cầu cần ship qua đích beta hoặc dev nhưng chưa tự merge.
Kết quả:
Ship PR đích beta đã review, gắn ready-to-ship beta và để merge ở trạng thái tắt.
Beta rồi stable
/ak:vibe --both https://github.com/acme/app/issues/42
Dùng khi:
Repo yêu cầu qua beta/dev trước khi release stable.
Kết quả:
Hoàn tất merge beta và CI xanh trước khi bắt đầu stage stable cùng review PR stable.
Có giám sát tư vấn
/ak:vibe --advice --ship https://github.com/acme/app/issues/42
Dùng khi:
Pipeline rủi ro cao cần thêm tư vấn nhưng không chuyển quyền sở hữu.
Kết quả:
Thêm tư vấn kongming tại các checkpoint bắt buộc nhưng vẫn giữ mọi gate pipeline và quyết định của owner.

Phạm vi xử lý

  • Phân tích yêu cầu
  • Tạo worktree
  • Gate kế hoạch
  • Đồng bộ issue
  • Triển khai theo route
  • Review local

Skill liên quan

Tiếp theo