Lập kế hoạch và thực hiện

Quy trình lập kế hoạch và thực hiện chia một phần việc cho hai vai trò: phiên lập kế hoạch chuẩn bị và nghiệm thu công việc, còn một hoặc nhiều phiên thực hiện triển khai công việc đó. Chương này trình bày cách bắt đầu quy trình từ menu hoặc từ một phiên, cách duyệt phương án chia nhiệm vụ, chọn thư mục làm việc và theo dõi tiến độ của quy trình.

1. Cách quy trình vận hành

Quy trình có hai vai trò, mỗi vai trò chạy như một phiên riêng trên thanh bên:

• Lập kế hoạch và nghiệm thu. Phiên lập kế hoạch tìm hiểu nhiệm vụ và dự án, soạn phần việc giao cho phiên thực hiện, rồi nghiệm thu từng kết quả. Phiên này yêu cầu chỉnh sửa cho đến khi kết quả đạt yêu cầu, và chỉ chấp nhận sau khi đã kiểm tra các thay đổi thực tế cùng bằng chứng kiểm chứng.
• Thực hiện. Phiên thực hiện triển khai phần việc được giao và báo cáo lại. Các yêu cầu chỉnh sửa được gửi cho chính phiên thực hiện đó, nên ngữ cảnh được giữ nguyên giữa các vòng.

Trên thanh bên, phiên thực hiện nằm dưới phiên lập kế hoạch dưới dạng phiên con. Cả hai phiên đều chạy trong chế độ hội thoại. Tin nhắn mà hai vai trò gửi cho nhau hiển thị biểu tượng tác nhân, tên phiên và vai trò (“Lập kế hoạch” hoặc “Thực hiện”) của bên gửi, nhờ đó bạn có thể theo dõi quá trình trao đổi ở cả hai cuộc hội thoại.

Cả hai vai trò đều cần một tác nhân hỗ trợ chế độ hội thoại: Claude Code, Codex, OpenCode, Pi hoặc OMP. Phiên lập kế hoạch và phiên thực hiện có thể dùng tác nhân, mô hình và mức suy luận khác nhau.

Bạn có thể đọc, trả lời hoặc ngắt bất kỳ phiên nào vào bất cứ lúc nào. Các yêu cầu cấp quyền từ cả hai vai trò vẫn chờ bạn trả lời.

2. Bắt đầu từ menu

Mở menu ngữ cảnh của một dự án, nhóm hoặc phiên, hoặc menu con “Phiên con mới” của phiên, rồi chọn “Phiên lập kế hoạch/thực hiện mới…”. Hộp thoại gồm:

• “Tạo trong”: vị trí tạo phiên lập kế hoạch. Phiên thực hiện được tạo bên dưới phiên lập kế hoạch.
• “Hướng dẫn nhiệm vụ”: mô tả nhiệm vụ, yêu cầu và tiêu chí nghiệm thu. Bạn có thể dán hình ảnh; hình ảnh được gửi kèm nhiệm vụ của phiên lập kế hoạch và phần việc đầu tiên giao cho phiên thực hiện.
• “Tự động chia thành nhiều nhiệm vụ”: xem §4.
• “Lập kế hoạch và nghiệm thu” và “Thực hiện”: tác nhân (“Loại phiên”), “Mô hình” và “Mức suy luận” cho từng vai trò. Các lựa chọn mô hình và mức suy luận lấy từ tác nhân được chọn. Hộp thoại ghi nhớ lựa chọn gần nhất của bạn cho từng vai trò.
• “Đường dẫn thư mục làm việc” và lựa chọn thư mục: xem §5.

Chọn “Tạo và khởi chạy” để khởi động phiên lập kế hoạch. Phiên lập kế hoạch sẽ tạo phiên thực hiện khi kế hoạch đã sẵn sàng. Việc mở hoặc hủy hộp thoại không tạo ra gì. Hộp thoại có địa chỉ riêng, nên bạn có thể sao chép liên kết, làm mới trang hoặc dùng nút quay lại và tiến tới mà không bị mất hộp thoại.

3. Bắt đầu từ một phiên

Bên trong bất kỳ phiên nào do VelaTerm khởi động, hãy chạy:

vspawn --plan-execute \
  --plan-agent claude --plan-model opus --plan-effort high \
  --exec-agent codex --exec-model gpt-5.5 --exec-effort medium \
  "Implement the agreed changes and verify all acceptance criteria"

Trong Claude Code, /vspawn --plan-execute <task> có tác dụng tương tự; trong Codex, hãy dùng $vspawn --plan-execute <task>. Kỹ năng này soạn một nhiệm vụ đầy đủ từ cuộc hội thoại hiện tại trước khi bắt đầu quy trình. Các kỹ năng này cần có Kỹ năng Vela (Cài đặt ▸ Chung).

Phiên lập kế hoạch mới được tạo bên dưới phiên đã chạy lệnh. Trước tiên, yêu cầu sẽ mở thẻ xác nhận được mô tả trong Tạo phiên và hợp tác Git §4, tại đó bạn có thể xem lại và thay đổi nhiệm vụ cũng như thiết lập của cả hai vai trò.

Khi không chỉ định tác nhân, phiên lập kế hoạch được khởi động từ một phiên Claude, Codex, OpenCode, Pi hoặc OMP sẽ dùng cùng tác nhân đó; nếu khởi động từ phiên khác, phiên lập kế hoạch dùng Claude Code. Mô hình hoặc mức suy luận mà tác nhân được chọn không hỗ trợ sẽ bị từ chối trước khi bất cứ phiên nào khởi động.

Các phiên mới không nhìn thấy cuộc hội thoại khởi tạo. Hãy đưa vào nhiệm vụ những quyết định đã có, các thay đổi hiện có, các ràng buộc và vị trí cần bàn giao kết quả.

4. Chia thành nhiều nhiệm vụ

Bật “Tự động chia thành nhiều nhiệm vụ” trong hộp thoại, hoặc thêm --split-tasks vào vspawn --plan-execute. Khi đó, phiên lập kế hoạch sẽ tìm hiểu công việc và đề xuất từ 1 đến 12 nhiệm vụ độc lập. Không phiên thực hiện nào khởi động cho đến khi bạn xác nhận các nhiệm vụ này.

Đề xuất sẽ mở hộp thoại “Xác nhận các nhiệm vụ thực hiện”:

• Chọn một nhiệm vụ trong danh sách để sửa “Tên phiên”, “Hướng dẫn nhiệm vụ”, tác nhân, “Mô hình” và “Mức suy luận”. Các chỉnh sửa vẫn được giữ khi bạn chuyển giữa các nhiệm vụ.
• “Bỏ nhiệm vụ” loại một nhiệm vụ; “Hoàn tác việc bỏ nhiệm vụ” đưa nhiệm vụ đó trở lại. Phải còn lại ít nhất một nhiệm vụ.
• Nút khởi động (“Khởi chạy N phiên”) tạo một phiên thực hiện cho mỗi nhiệm vụ.
• Đóng hộp thoại thì đề xuất vẫn ở trạng thái chờ. Khi đó, liên kết “Xác nhận các nhiệm vụ thực hiện” vẫn hiển thị trên màn hình để mở lại hộp thoại. Hủy đề xuất sẽ dừng quy trình mà không tạo phiên thực hiện nào.
• Hộp thoại có địa chỉ riêng và vẫn còn sau khi làm mới trang; tuy nhiên, các chỉnh sửa chưa được xác nhận sẽ bị mất khi làm mới.

Khi dùng kỹ năng với tính năng chia nhiệm vụ, kỹ năng sẽ thêm --yes để chỉ còn bước duyệt cuối cùng này. Bước duyệt có thể thay đổi thiết lập của từng phiên thực hiện, nhưng không thay đổi được thiết lập của phiên lập kế hoạch vì phiên này đã đang chạy.

Một phiên lập kế hoạch nhận báo cáo của mọi phiên thực hiện và nghiệm thu riêng từng nhiệm vụ, mỗi nhiệm vụ có các vòng chỉnh sửa riêng. Toàn bộ quy trình chỉ hoàn tất khi mọi nhiệm vụ đều đã được chấp nhận.

Hãy chia nhiệm vụ thành các phần không cùng sửa những tệp giống nhau. Mỗi phiên thực hiện chạy một tiến trình tác nhân riêng, vì vậy hãy chọn số lượng nhiệm vụ phù hợp với tài nguyên của máy.

5. Thư mục làm việc và worktree

Lựa chọn thư mục áp dụng cho mọi vai trò trong quy trình:

Worktree mới được tạo từ commit hiện tại và không bao gồm các thay đổi chưa commit. Nếu không tạo được worktree, phiên bị ảnh hưởng sẽ không khởi động; phiên đó không chuyển sang dùng một thư mục khác. Trên dòng lệnh, chỉ dùng --worktree có nghĩa là shared.

Kết quả nằm lại trong các worktree cho đến khi bạn hợp nhất. Dùng “Git ▸ Hợp nhất…” trên một phiên để hợp nhất một nhánh (xem Tạo phiên và hợp tác Git §6). Quy trình không tự hợp nhất, đẩy (push) hay xóa worktree.

6. Theo dõi tiến độ

• Cuộc hội thoại của phiên lập kế hoạch hiển thị mọi báo cáo và yêu cầu chỉnh sửa ngay khi chúng diễn ra. Trong lúc các phiên thực hiện làm việc, phiên lập kế hoạch chờ báo cáo của các phiên này.
• vflow status <workflow-id> hiển thị trạng thái của một quy trình, các nhiệm vụ, các phiên và vòng hiện tại. ID quy trình xuất hiện trong các tin nhắn của quy trình.
• vflow stop <workflow-id> dừng các vòng tiếp theo và yêu cầu các phiên đang chạy dừng lại. Dừng toàn bộ quy trình sẽ dừng mọi nhiệm vụ của quy trình; dừng một nhiệm vụ không ảnh hưởng đến các nhiệm vụ khác.
• vstat cho biết phiên nào đang làm việc, đang xin cấp quyền hoặc đang chờ. Một phiên thực hiện đang chờ chưa chắc đã hoàn thành nhiệm vụ; chỉ việc phiên lập kế hoạch chấp nhận kết quả mới được tính là hoàn thành.
• Nếu một vai trò kết thúc lượt mà không chuyển giao công việc, quy trình sẽ bị chặn. Hãy kiểm tra cuộc hội thoại, trả lời những gì cần thiết và tiếp tục từ phiên lập kế hoạch.

Các lệnh được mô tả trong Lệnh trong phiên.