Worktree checkpoint

Mỗi worktree Orca mang theo một field comment free-text nhẹ, hiển thị trên UI - một snapshot trạng thái về việc worktree đó đang làm ngay lúc này. Agent có thể cập nhật nó từ CLI, và đây là pattern chúng tôi khuyến nghị để giữ người cộng tác trong vòng lặp mà không ép buộc phải chat.

Pattern

orca worktree set --worktree active --comment "reproduced auth failure; testing credential-chain fix" --json

Trạng thái card (tuỳ chọn)

Cùng với comment free-text, đặt trạng thái card workspace khi giai đoạn thay đổi:

orca worktree set --worktree active \
  --comment "fix implemented; running integration tests" \
  --workspace-status in-progress \
  --json

Trạng thái: todo, in-progress, in-review, completed (hoặc một id tuỳ chỉnh workspace của bạn đang dùng).

Thời điểm checkpoint tốt

• Vừa hoàn thành một phần implementation có ý nghĩa.
• Vừa xác nhận hoặc bác bỏ một giả thuyết.
• Vừa hoàn thành một lượt code review.
• Vừa gặp một blocker (chờ input bên ngoài, bug upstream, thiếu quyền truy cập).
• Chuyển từ điều tra sang sửa, hoặc từ sửa sang xác minh.

Định dạng

Dòng đầu tiên là hành động: vừa xảy ra gì, ở đâu, và trạng thái hoặc bước tiếp theo.

orca worktree set --worktree active --comment "added debounce to SearchBar onChange (src/components/SearchBar.tsx); ready for review
goal: reduce redundant API calls per #298" --json

Đọc trước khi ghi

Nếu comment có thể chứa context do người dùng viết, đọc nó trước để không ghi đè mất mục tiêu hay ràng buộc đã có:

orca worktree current --json

Giữ lại những gì vẫn còn giá trị, bỏ những gì đã cũ, và lồng ghép cập nhật của bạn vào.

Nguồn

Dịch và biên soạn từ trang Worktree checkpoints trong tài liệu chính thức của Orca ADE (onorca.dev).