Tạo phiên và hợp tác Git

Hai tính năng hoạt động song song: tạo các tiểu nhiệm trong các phiên con độc lập bằng cách sử dụng vspawn (có thể trong các worktree git tách biệt), và chức năng hợp nhất đồ họa để kết hợp lại các nhánh song song. Cùng nhau chúng biến việc “nhiều tác nhân làm cùng một kho mã một cách song song” thành quy trình làm việc hàng ngày.

1. Khái niệm về việc tạo phiên con

Từ bất kỳ phiên nào, hãy tách ra một tiểu nhiệm: VelaTerm tạo một phiên con mới ** dưới** nút hiện tại (cấu trúc cây trở nên phân cấp: cha → con → cháu), có thể cung cấp một worktree git tách biệt, và đưa mô tả nhiệm vụ vào làm thông báo đầu tiên của phiên con mới — phiên tác nhân bắt đầu làm việc ngay khi khởi động, không cần giải thích lại.

Kết quả bạn nhận được là một phiên thực sự trong cấu trúc cây — có quy trình riêng, hoàn toàn tương tác, có thể tiếp tục từ chỗ dừng — mà bạn có thể theo dõi hoặc chuyển sang sử dụng bất kỳ lúc nào. Đây không phải là một nhiệm vụ ẩn ở nền.

2. Bốn cách truy cập

Hai lệnh terminal này được chèn tự động vào PATH của mọi phiên — không cần cài đặt gì cả.

Điều kiện tiên quyết cho các kỹ năng /: trước khi Claude có thể sử dụng /vspawn hoặc /vspawn-tree (hoặc tự tạo các phiên con), hãy kích hoạt Vela Skills trong Settings ▸ General. Điều này sẽ cài đặt các kỹ năng /vspawn, /vspawn-tree và /vopen dưới dạng gói vào ~/.claude/skills/; chúng sẽ được cập nhật tự động khi ứng dụng được nâng cấp. Sau khi kích hoạt, hãy bắt đầu một phiên Claude mới (hoặc khởi động lại phiên hiện có) để tác nhân có thể nhận các kỹ năng này. Nếu không làm vậy, Claude sẽ không biết các lệnh này — chỉ có các lệnh vspawn / vspawn-tree được gõ qua terminal mới hoạt động.

3. Xác nhận trước khi tạo phiên con

Theo mặc định, mỗi lần tạo phiên con đều hiển thị một thẻ xác nhận (ở góc trên bên phải, không làm mất tập trung):

• Ba trường có thể chỉnh sửa: mẫu yêu cầu **** (nhiều dòng), loại agent (mặc định giống cha), và tùy chọn worktree git riêng biệt.
• Nút “Launch” khởi động phiên con; nút “Cancel” hủy yêu cầu. Khi tác nhân tạo nhiều phiên con cùng lúc, các thẻ sẽ được xử lý từng cái một (số lượng còn lại được hiển thị trên thẻ).
• Nếu bạn muốn bỏ qua bước xác nhận hoàn toàn, hãy tắt tùy chọn “Confirm before spawn” trong Settings ▸ Behavior.

4. Worktree: làm việc song song mà không can thiệp lẫn nhau

Khi tùy chọn worktree được bật, phiên con sẽ làm việc trên một nhánh mới trong thư mục làm việc riêng của nó — tách biệt khỏi không gian làm việc chính và các phiên con khác. Đây chính là cấu trúc phù hợp cho việc song song hóa nhiều tác nhân. Việc quản lý được thực hiện qua menu ngữ cảnh của phiên dưới mục “Worktree ▸”: xem các thay đổi, sao chép/mở thư mục worktree, xóa worktree (có tùy chọn ép xóa các thay đổi chưa được ghi lại).

Việc tạo phiên con từ thư mục không phải git vẫn hoạt động; nó sẽ chuyển sang chia sẻ thư mục của cha mà không có worktree.

5. Hợp nhất: chức năng hợp nhất đồ họa Git

Khi công việc hoàn tất, hãy hợp nhất chúng lại. Bất kỳ phiên nào có thư mục làm việc là một kho mã git (có worktree hay không): nhấp chuột phải → “Git ▸ Merge…” để mở hộp thoại hợp nhất:

• **Bạn chọn cả nhánh nguồn và nhánh đích **, và có thể đổi chiều hướng — hợp nhất nhánh của phiên con trở lại nhánh chính, hoặc kéo nhánh chính vào phiên con để cập nhật dữ liệu cơ sở, tất cả đều từ cùng một hộp thoại.
• Việc hợp nhất được thực hiện trong worktree nơi nhánh đích đang được kiểm tra; nếu thư mục nguồn có các thay đổi chưa được ghi lại, chúng sẽ được ghi lại trước để không bị mất mát.
• Khi xảy ra xung đột, cảnh tượng sẽ được giữ nguyên để bạn (hoặc một tác nhân) có thể giải quyết trong terminal và tiếp tục công việc.

Việc hợp nhất sẽ không tự động xóa worktree — hãy dọn dẹp nó sau đó bằng cách chọn “Worktree ▸ Delete worktree…” khi bạn chắc chắn.

6. Quy trình làm việc điển hình

1. Trong phiên chính, hãy yêu cầu Claude phân tích nhiệm vụ, sau đó /vspawn-tree refactor the checkout module để tạo phiên con (cần Vela Skills — xem mục 2).
2. Xem xét mẫu yêu cầu trên thẻ xác nhận và nhấn Launch — phiên con sẽ bắt đầu hoạt động trong worktree riêng của nó, hiển thị ở thanh bên dưới phía dưới cha của nó, với dấu chấm chuyển sang màu xanh.
3. Bạn tiếp tục làm việc trong phiên chính; khi phiên con yêu cầu gì đó hoặc hoàn thành công việc, dấu chấm của nó sẽ chuyển sang màu vàng và có thông báo hiện lên.
4. Chuyển sang xem xét, sau đó nhấp chuột phải → “Git ▸ Merge…” để hợp nhất nhánh của nó trở lại nhánh chính.
5. Sử dụng “Worktree ▸ Delete worktree…” để dọn dẹp, sau đó lưu trữ phiên con lại làm tài liệu ghi chép.