Các Thực hành Tốt nhất — 10 Mẹo
Các Thực hành Tốt nhất — 10 Mẹo — hướng dẫn dễ hiểu dựa trên tài liệu chính thức
Hãy nghĩ về Hermes Agent như một đầu bếp trong căn bếp đông đúc. Bạn sẽ không để mọi đầu bếp thái rau trên cùng một thớt trong khi cũng đang trang trí món tráng miệng — bạn sẽ cho mỗi người một khu vực làm việc riêng. Logic tương tự cũng áp dụng cho codebase của bạn.
1. Một Worktree Cho Mỗi Thử Nghiệm
Hãy tưởng tượng bạn đang sơn một ngôi nhà. Bạn sẽ không sơn phòng khách và phòng tắm cùng lúc với cùng một cây cọ — bạn sẽ làm hỏng cả hai. Git worktree cho phép bạn cấp cho mỗi tác vụ Hermes một “căn phòng” riêng để làm việc.
Thay vì để Hermes chỉnh sửa file trực tiếp trong thư mục dự án chính, hãy tạo một không gian làm việc riêng cho mỗi thử nghiệm. Điều này giữ cho code chính của bạn an toàn và các thay đổi luôn gọn gàng.
2. Đặt Tên Branch Theo Thử Nghiệm
Đặt cho branch của bạn những cái tên rõ ràng, mô tả được nội dung để bạn (và cả “bạn” trong tương lai) biết mỗi branch dùng để làm gì:
git checkout -b feature/hermes-checkpoints-docs
Đừng đặt branch-1 hay test-fix. Hãy cụ thể — bạn sẽ tự cảm ơn mình sau này.
3. Commit Thường Xuyên
Hãy nghĩ về commit như việc lưu tiến trình trong một trò chơi điện tử. Bạn không muốn chơi ba tiếng đồng hồ rồi mất hết vì không lưu.
Commit ở các mốc quan trọng:
git add .
git commit -m "Add checkpoint documentation"
Đối với các thay đổi nhỏ do công cụ tạo ra ở giữa chừng, hãy dùng checkpoints và /rollback của Hermes như một tấm lưới an toàn.
4. Tránh Chạy Từ Thư Mục Gốc Của Repo
Khi dùng worktree, đừng chạy Hermes từ thư mục repo gốc. Thay vào đó, hãy cd vào thư mục worktree. Điều này giúp mỗi agent có một phạm vi rõ ràng và ngăn chặn việc vô tình làm lẫn lộn giữa các phiên làm việc.
5. Dùng hermes -w Để Tự Động Tạo Worktree
Không muốn thiết lập worktree thủ công? Hermes có sẵn một phím tắt:
cd /path/to/your/repo
hermes -w
Lệnh này tự động tạo một worktree dùng một lần với branch riêng của nó. Bạn thậm chí có thể kết hợp với một truy vấn duy nhất:
hermes -w -z "Fix issue #123"
6. Chạy Nhiều Agent Song Song An Toàn
Muốn nhiều Hermes agent làm việc cùng lúc? Chỉ cần mở nhiều terminal và chạy hermes -w trong mỗi terminal. Mỗi phiên làm việc sẽ tự động có một worktree và branch riêng biệt. Không còn cảnh các agent giẫm chân lên nhau nữa.
7. Dùng Checkpoints + /rollback
Sai lầm là chuyện thường tình. Không sao cả. Hermes cho phép bạn tạo checkpoints trong một phiên làm việc và quay lại chúng nếu có sự cố. Giống như có một nút “hoàn tác” cho các hành động của agent vậy.
8. Kết Hợp Worktree, Branch Và Checkpoints
Đây là công thức chiến thắng:
- Worktree = bản checkout sạch sẽ cho mỗi phiên làm việc
- Branch = lịch sử cấp cao của các thử nghiệm
- Checkpoints +
/rollback= khôi phục nhanh từ sai lầm
Kết hợp lại, chúng mang lại cho bạn vòng lặp nhanh, khả năng khôi phục dễ dàng và các pull request sạch sẽ.
9. Xử Lý Phát Triển UI Một Cách Thông Minh
Nếu bạn đang làm việc trên TUI hoặc ứng dụng desktop qua nhiều worktree, bạn sẽ cần node_modules cho từng cái. Đó là rất nhiều file trùng lặp. Hãy xem các helper htui / hgui — chúng chia sẻ một bản cài đặt duy nhất qua symlink — giúp tiết kiệm dung lượng ổ đĩa và thời gian thiết lập.
10. Giữ Branch Chính Luôn Sạch Sẽ
Toàn bộ ý nghĩa của những thực hành này là giữ cho branch chính của bạn ổn định và sẵn sàng cho production. Chỉ merge các branch worktree khi chúng đã được kiểm thử và hoàn chỉnh.
Tóm Lại
Hãy nghĩ về worktree như những chiếc bàn riêng trong một văn phòng. Mỗi Hermes agent có bàn làm việc riêng với công cụ riêng, nên không ai làm hỏng việc của người khác. Branch là hệ thống lưu trữ hồ sơ của bạn, còn checkpoint là những tờ ghi chú dán “tôi đã ở đây”.
Mẹo thực tế: Bắt đầu chỉ với hermes -w cho tác vụ tiếp theo của bạn. Đó là cách dễ nhất để có sự cô lập mà không cần thiết lập thủ công. Khi đã quen, hãy thêm checkpoints và rollback vào quy trình làm việc. Bạn sẽ tự hỏi tại sao trước đây mình lại làm việc mà không có chúng.
📖 Tài liệu chính thức
この記事は Hermes Agent のTài liệu chính thứcに基づいています:Tài liệu chính thức › guides/tips