Annotate AI Diff

Annotate AI Diff là vòng lặp review inline của Orca cho code do agent tạo ra. Bạn để lại comment trên bất kỳ dòng nào của bất kỳ hunk do AI sinh ra, rồi gửi tất cả lại cho agent thành một batch duy nhất để sửa - không cần chép số dòng, không cần chuyển qua chuyển lại context.

Để lại comment

1. Hover vào bất kỳ dòng nào trong diff. Một dấu + xuất hiện ở gutter.
2. Click vào đó (hoặc bấm c khi con trỏ đang ở dòng đó).
3. Gõ feedback của bạn - hỗ trợ markdown.
4. Bấm Cmd-Enter để lưu, Esc để hủy.

Comment gắn chặt vào đúng dòng; Orca theo dõi chúng qua các lần chỉnh sửa để chúng luôn bám theo đúng dòng nếu diff dịch chuyển.

Gửi cả batch

Khi review xong, click Send to agent ở đầu diff. Orca soạn một prompt duy nhất gồm mọi comment của bạn, gắn theo từng dòng, rồi mở menu Send notes to liệt kê các agent khả dụng của worktree. Chọn agent nào sẽ sửa lại thay đổi, hoặc khởi động một agent mới ngay từ menu đó.

Send Review Notes to Agent mặc định không gán phím tắt để tránh xung đột với tổ hợp khác. Gán nó ở Settings → Shortcuts để mở menu gửi này bằng bàn phím (hoạt động ngay cả khi editor đang được focus).

Vì sao phải gửi theo batch?

Gửi comment từng cái một khiến agent lúng túng sửa qua sửa lại. Gộp thành batch giữ feedback mạch lạc: một vòng suy nghĩ, một lượt sửa, và tỷ lệ đúng cao hơn hẳn.

Reply, resolve, review lại

• Comment vẫn gắn nguyên vị trí sau khi agent sửa - dùng chúng để xác nhận bản sửa đã đúng.
• Click Resolve để thu gọn một thread.
• Comment chưa resolve sẽ nằm trong batch tiếp theo nếu bạn bấm Send lần nữa.

Nguồn

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