Hosted review, issue & Actions

Hosted code review là một phần hạng nhất của worktree. Orca gắn worktree với pull request hoặc merge request tương ứng, hiện trạng thái review ngay inline, và cho phép bạn triage issue mà không cần rời khỏi app.

Kết nối một provider

Kết nối provider mà repo của bạn dùng từ Settings → Integrations. GitHub có hỗ trợ Actions và issue sâu nhất; merge request và issue của GitLab dùng chung luồng review worktree.

Bitbucket Cloud kết nối ngay trong app từ cùng panel - Connect bằng Email & API token hoặc Access token. Orca xác minh credential trước khi lưu và có thể tạo pull request từ Source Control. Bitbucket Cloud không có draft PR nên composer sẽ ẩn toggle Draft. Biến môi trường ORCA_BITBUCKET_* vẫn được ưu tiên hơn credential đã lưu. Pull request của Azure DevOps và Gitea hiện trên sidebar worktree và panel Checks cạnh GitHub, GitLab, và Bitbucket - luồng tạo worktree kiểm tra chúng để tìm xung đột remote trước khi push.

Review

• Mở một hosted review từ panel Source Control sau khi worktree đã được push - xác nhận base branch, title, description, và trạng thái draft trước khi tạo.
• Source Control giữ branch hiện tại hiển thị trong dòng context branch trong lúc bạn tạo hoặc mở một hosted review, nên action Create PR không bao giờ thay thế nhãn branch.
• Review đã liên kết hiện trên sidebar kèm trạng thái để bạn biết branch còn mở, đã merge, hay đã đóng.
• Dòng context branch hiện link gọn Open review page in browser khi Orca có URL cho PR / MR đã liên kết - một click nhảy tới review trên GitHub, GitLab, Bitbucket, Azure DevOps, hoặc Gitea mà không cần mở view PR nội bộ.
• Với GitHub pull request, dùng menu action PR trên sidebar để copy link review, đóng review, hoặc mở lại sau khi xác nhận thay đổi trạng thái.
• Check, review, và comment của GitHub mở inline trong một tab PR; merge request và issue của GitLab mở trong cùng bề mặt review đó.
• Với pipeline GitLab, panel Checks bên cạnh gồm cả job bridge và child pipeline (không chỉ job cấp cao nhất). Mở rộng một job sẽ tải trace (log) của job đó nếu có - cùng chỗ chi tiết check của GitHub mở ra - nên job fail không phải là ngõ cụt “không có chi tiết inline”.
• Trong panel Checks, bạn có thể reply bất kỳ comment nào trong một review thread, không chỉ comment gốc.
• Comment trong conversation của GitHub PR và comment trong review thread inline có bộ chọn reaction khớp với 8 reaction của GitHub (👍 👎 😄 😕 ❤️ 🎉 🚀 👀). Các chip đã có là toggle. Comment của GitLab không đổi.
• Các mục comment PR được nhóm sắp xếp mới nhất trước, để một reply mới đẩy thread của nó lên đầu. Tab Timeline vẫn giữ cũ nhất trước.
• Khi một GitHub pull request có check thất bại, dùng Fix broken checks từ view PR để giao tên và link các check thất bại cho một agent.

Auto-merge

Với GitHub PR đang mở, nút merge trên view PR có tuỳ chọn Enable auto-merge để GitHub tự merge branch ngay khi các yêu cầu (check, review bắt buộc) đạt. Phương thức merge theo mặc định của repo, là một trong Squash and merge, Create merge commit, hoặc Rebase and merge - phương thức repo không cho phép sẽ không hiện. Dùng Disable auto-merge từ cùng control để hủy một auto-merge đang chờ. Khi base branch dùng merge queue của GitHub, cùng control đó hiện Merge when ready và thêm PR vào queue thay vì merge ngay. Control auto-merge bị ẩn với các PR mà GitHub báo là draft, closed, conflicting, hoặc unstable, và với repo không cho phép auto-merge - trong các trường hợp đó bạn chỉ thấy action merge thủ công.

Stacked pull request

Khi bạn tạo một GitHub pull request có base đã chọn sẵn một PR đang mở, composer đưa ra tuỳ chọn Stack this PR above #N. Chọn nó sẽ tạo một GitHub Stack (hoặc mở rộng stack sẵn có của parent) và đổi nhãn submit thành Create PR in stack (hoặc Create draft PR in stack / Push & Create PR in stack). Một preview nhỏ hiện PR cha và branch mới. Tuỳ chọn này chỉ dành riêng cho GitHub và chỉ xuất hiện khi host đang thực thi hỗ trợ tạo stack. Merge request của GitLab và pull request của Bitbucket vẫn giữ luồng tạo single-PR.

Khi GitHub đăng ký một pull request là một phần của stack, sidebar PR hiện một bản đồ Stack #N thu gọn được: vị trí của bạn trong stack, kích thước stack, và base branch của stack. Mở rộng để xem các lớp theo thứ tự kèm trạng thái (open, draft, checks pending/failed, review needed, conflicts, merged, closed). Click một lớp để mở PR đó trong Orca.

Merge nhận biết stack thay nhãn merge single-PR bằng Merge through #N · M PRs (hoặc Queue through #N · M PRs khi repo dùng merge queue). Action đó bao trùm PR hiện tại và mọi PR nằm dưới nó trong stack. Xác nhận liệt kê các số PR liên quan khi metadata stack đầy đủ. Merge stack là atomic và fail-closed - nếu một lớp nào không merge được, không lớp nào merge cả. Chuỗi PR phụ thuộc thông thường không có metadata stack đăng ký với GitHub vẫn giữ luồng merge single-PR bình thường. Merge request của GitLab không thay đổi.

Issue

Drawer issue cho phép bạn duyệt, lọc, và sửa issue của GitHub và GitLab ngay trong Orca. Tạo worktree từ một GitHub issue hoặc PR sẽ mở composer workspace tương tác (không phải tạo ngầm im lặng), nên automation theo lệnh issue, SSH target, và folder workspace hoạt động giống các đường tạo khác. Composer tự điền tên task và liên kết issue để review luôn gắn với task.

Với GitHub issue, dialog chi tiết có mục Activity xen kẽ comment với sự kiện timeline - assignment, mention, cross-reference, thay đổi trạng thái, và di chuyển cột project - để bạn xem toàn bộ lịch sử mà không cần rời Orca.

Dùng menu issue liên kết trên sidebar workspace để copy link issue mà không cần mở drawer.

Với repo GitLab, drawer liệt kê issue đang mở của project đã chọn và có thể thu hẹp danh sách còn issue được assign cho bạn.

Actions

Check GitHub Actions thất bại hiện thành một chip đỏ trên worktree. Click vào đó để xem log job thất bại inline.

Tasks

Orca hiện một view GitHub Projects đầy đủ dưới mục sidebar Tasks - duyệt card project trên nhiều repo, lọc theo repo nguồn, xem trạng thái draft pull request, và tạo worktree từ bất kỳ card nào.

Xử lý sự cố

Nếu trạng thái PR, check, hoặc Tasks không refresh được - rate limit, auth gh, quyền, hoặc mạng - xem Xử lý sự cố lỗi GitHub.

Bước tiếp theo

• Commit & push từ Orca - stage thay đổi, push branch, rồi tạo hosted review.
• Linear items drawer - dùng Linear khi nguồn task nằm ngoài git provider của bạn.
• Xử lý sự cố lỗi GitHub - rate limit, auth, và lỗi gh.

Nguồn

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