Kết luận

Mỗi mục nhận một kết luận cho từng thao tác có thể thực hiện, và kết luận luôn kèm lý do. Màu sắc không bao giờ là dấu hiệu duy nhất: mỗi kết luận có họa tiết riêng, ký hiệu riêng và quy tắc riêng.

Mục Bị chặn và Không rõ không bao giờ chọn được. Mục Cần xem chỉ được dọn khi chọn “Vẫn đưa vào”.

Bốn kết luận

Kết luận Ý nghĩa Khi dọn
READYSẵn sàng Đã qua mọi kiểm tra cho thao tác này. Được chọn sẵn.
REVIEWCần xem Một rủi ro đã biết, hoặc một quyết định chỉ bạn mới đưa ra được. Với “Vẫn đưa vào”.
BLOCKEDBị chặn Đang dùng, được bảo vệ, hoặc còn chứa công việc mà git sẽ từ chối bỏ đi. Không chọn được.
UNKNOWNKhông rõ Chưa đủ bằng chứng. Không chọn được, không bao giờ tính là Sẵn sàng.

Dòng lệnh in ra cùng các kết luận này bằng chữ in hoa (tiếng Anh).

Lý do

Lý do của một kết luận nói rõ những gì đã biết về mục đó. Ví dụ:

  • Thuộc agent nào: “Thuộc một phiên Claude Code đang chạy”, hoặc công cụ nào đã tạo ra nó.
  • Có đang được dùng không: một phiên agent đang chạy trong nó hoặc trong thư mục cha, một tiến trình chạy từ đó, một tệp đang mở.
  • Công việc chưa lưu: tệp đã sửa, chưa theo dõi hoặc đã stage; commit chưa push; khóa git.
  • Bằng chứng: khi chỉ cái tên là chưa đủ, đó là dấu hiệu mà Devbroom tìm, như package.json nằm cạnh node_modules.

Sẵn sàng

Đã qua mọi kiểm tra. Khi bạn nhấn Dọn dẹp, mục đó vẫn được kiểm tra thêm một lần; nếu có gì thay đổi trong lúc đó, nó được giữ nguyên.

Cần xem

Xóa nó rất có thể không sao, nhưng có điều Devbroom không thể biết. Ví dụ:

  • Một tệp .env bị bỏ qua trong worktree: git worktree remove sẽ xóa nó mà không hỏi. git status sạch không chứng minh bên trong không có gì giá trị.
  • Tên trông như thư mục build, nhưng các tệp dự án có thể chứng minh điều đó không nằm cạnh nó.
  • Các tên mơ hồ như dist, build và vendor, trừ khi một script build tạo ra chúng.
  • Cache tốn công tải lại: pnpm store, trình duyệt của Playwright, model của Hugging Face.
  • Thư mục do chính agent quản lý.

Bị chặn

Đụng vào lúc này có thể làm hỏng công việc của ai đó:

  • Một phiên agent chạy trong nó hoặc trong thư mục cha, một tiến trình chạy từ đó, hoặc một tệp bên trong đang mở.
  • Worktree có thay đổi chưa commit, tệp chưa theo dõi hoặc thay đổi đã stage. Git không xóa nó nếu thiếu --force; Devbroom không bao giờ dùng --force.
  • Bản làm việc chính, worktree có submodule, hoặc worktree bị git khóa.
  • Các tệp được bảo vệ như cơ sở dữ liệu và thông tin xác thực của agent.
  • Những thứ chỉ nên dọn bằng lệnh riêng của agent.

Không rõ

Không xác định được thứ này thuộc agent nào, hoặc một phần không đọc được. Devbroom không bao giờ tính thứ nó không biết là Sẵn sàng.

Quy tắc của riêng bạn

Một tệp .devbroom.toml ở gốc dự án có thể khai báo những gì được coi là kết quả build trong dự án đó. Vì một agent cũng có thể đã viết tệp đó, dòng lệnh không tin nó nếu chưa hỏi: devbroom clean --yes loại ra mọi thứ chỉ Sẵn sàng nhờ tệp đó.

TrướcBắt đầu TiếpNguyên tắc

Cập nhật lần cuối: 7 tháng 10, 2026