/vibe — Autonomous pipeline

Skill mới trong bộ claudekit — /vibe chạy end-to-end pipeline tự động: từ issue → plan (TDD + validate) → implement → review → ship PR → merge. Thay thế việc gọi từng skill một, giúp dev tập trung vào logic thay vì flow.

Tổng quan

Pipeline /vibe thực hiện 10 bước liên tiếp:
  1. Worktree — Tạo nhánh làm việc sạch từ main
  2. Plan — Viết plan TDD, validate với red-team, cập nhật issue
  3. Issue Update — Sync issue status → “In Progress”
  4. Cook — Implement code theo plan, chạy test
  5. Code Review — Self-review code với /ck-review
  6. Ship PR — Push và tạo PR tự động
  7. Review PR — Comment và approve trên PR
  8. Label — Thêm label (test-passed, review-approved)
  9. Merge — Merge PR với --ship flag nếu auto-approve
  10. CI Watch — Monitor CI/CD qua GitHub Actions
Dùng /vibe khi muốn ship tính năng hoàn chỉnh, không chỉ code một phần.

Prefix & flags


Workflow

1

Bước 1: Khởi động

Gọi /vibe với issue GitHub URL.
2

Bước 2-3: Plan & Validate

Pipeline tạo plan TDD:
  • Viết test cases (red phase)
  • Define API/schema
  • Red-team: “What can break?”
  • Update issue: “Plan ready, starting cook”
3

Bước 4-5: Cook & Review

Implement theo plan:
  • Write code
  • Run tests → green
  • Self-review với /ck-review
  • Check linting, types
4

Bước 6-7: Ship & Approve

Push code, tạo PR:
  • Commit message theo conventional format
  • Create PR với body từ plan
  • Auto-comment: “Reviewed and approved”
5

Bước 8-10: Merge & Monitor

Label + merge:
  • Add: test-passed, review-approved
  • Merge strategy: squash or rebase (configurable)
  • Watch CI: Wait for green

Ví dụ thực tế

Case 1: Feature đơn giản, auto-merge

Kết quả:
  • Plan written & red-teamed
  • Code implemented & tested
  • PR created → approved → merged tự động
  • CI/CD running
  • Issue closed: “Shipped in PR #567”

Case 2: Feature có risk, cần manual approval

Kết quả:
  • Plan written & red-teamed
  • Code implemented & tested
  • PR created → waiting for human approval
  • Dev or lead can review, then merge manually
  • CI/CD running

Case 3: Beta feature, merge vào develop

Kết quả:
  • Plan & code on feature branch
  • PR created against beta branch
  • Auto-merged vào beta
  • CI/CD runs on beta
  • Later: cherry-pick vào main sau testing

So sánh với skill khác


Common pitfalls

Sai lầm phổ biến:
  • Chạy trước khi có issue: /vibe cần issue URL. Tạo issue trước rồi gọi /vibe
  • Quên push code: Nếu code có sẵn nhưng chưa push, /vibe sẽ fail. Dùng /cook trước
  • Sai GitHub token: Nếu gh command không hoạt động, PR tạo fail. Check: gh auth status
  • Plan không pass validation: Nếu red-team catch bugs, quay lại /plan --fix trước khi /cook
  • Auto-merge vào main khi cần hotfix branch: Dùng --beta hoặc manual flow thay vì --ship

FAQ

A: Không nên. Validation (red-team) catch 70% bugs trước khi code. Nếu fail:
  1. Review lại plan
  2. Fix issues → revalidate
  3. Rồi mới /cook
Nếu muốn skip (risky), dùng /cook trực tiếp thay vì /vibe.
A: Có. /vibe là linear, nhưng mỗi step tạo checkpoint:
  • Sau /plan: file plans/XXX-<date>.md
  • Sau /cook: commits trên worktree
  • Pause bao lâu tùy ý → /vibe --resume <step> để tiếp
(Note: --resume flag phụ thuộc vào implementation)
A: Không. /vibe là pipeline kín. Nếu muốn skip:
  • Skip self-review? Dùng /cook --no-review + manual /ship
  • Skip red-team? Dùng /plan --quick → /cook
  • Skip CI watch? Dùng --no-watch flag
Nhưng không recommend — validation và review bảo vệ code quality.
A: /vibe watch CI đến khi pass. Nếu fail:
  1. Pipeline stop ở bước “CI Watch”
  2. Tạo issue mới, fix bug, chạy /vibe lại
  3. Hoặc manual revert + hotfix
A: Có, nhưng:
  • Dùng --beta hoặc create feature-branch thay vì main
  • Nếu quá cấp tính, skip /vibe → dùng /fix + manual merge
  • /vibe là best-practice pipeline, emergency có thể cần shortcut

Xem thêm