🤖HermesBlog
Hướng dẫn Thực hành Hermes · Parte 18/9/2026

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.


guide-tips

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