Sử dụng SOUL.md với Hermes
SOUL.md là danh tính chính cho phiên bản Hermes của bạn. Đó là điều đầu tiên trong lời nhắc của hệ thống — nó xác định nhân viên hỗ trợ là ai, cách họ nói và những gì họ tránh.
Nếu bạn muốn Hermes có cảm giác giống như một trợ lý giống nhau mỗi khi bạn nói chuyện với nó - hoặc nếu bạn muốn thay thế hoàn toàn nhân cách Hermes bằng nhân vật của chính mình - thì đây chính là tài liệu bạn nên sử dụng.
SOUL.md dùng để làm gì
Sử dụng SOUL.md cho:
- giai điệu
- tính cách
- phong cách giao tiếp
- Hermes nên thẳng thắn và ấm áp như thế nào
- những gì Hermes nên tránh về mặt phong cách
- Hermes nên liên hệ như thế nào với sự không chắc chắn, bất đồng và mơ hồ
Tóm lại:
SOUL.mdnói về Hermes là ai và Hermes nói như thế nào
Những gì SOUL.md không dành cho
Không sử dụng nó cho:
- quy ước mã hóa dành riêng cho repo
- đường dẫn tập tin
- lệnh
- Cảng dịch vụ
- ghi chú kiến trúc
- hướng dẫn quy trình làm việc của dự án
Những thứ đó thuộc về AGENTS.md .
Một quy tắc tốt:
- nếu nó áp dụng được ở mọi nơi, hãy đặt nó vào
SOUL.md - nếu nó chỉ thuộc về 1 dự án thì cho vào
AGENTS.md
Nơi nó sống
Hermes hiện chỉ sử dụng tệp SOUL toàn cầu cho phiên bản hiện tại:
~/.hermes/SOUL.md
Nếu bạn chạy Hermes với một thư mục chính tùy chỉnh, nó sẽ trở thành:
$HERMES_HOME/SOUL.md
Hành vi lần đầu tiên
Hermes tự động tạo một bộ khởi động SOUL.md cho bạn nếu chưa có bộ khởi động nào.
Điều đó có nghĩa là hầu hết người dùng hiện nay đều bắt đầu với một tệp thực mà họ có thể đọc và chỉnh sửa ngay lập tức.
Quan trọng:
- nếu bạn đã có
SOUL.md, Hermes sẽ không ghi đè lên nó - nếu tệp tồn tại nhưng trống, Hermes không thêm gì vào dấu nhắc
Hermes sử dụng nó như thế nào
Khi Hermes bắt đầu một phiên, nó sẽ đọc SOUL.md từ HERMES_HOME , quét nó để tìm các mẫu chèn lời nhắc, cắt bớt nó nếu cần và sử dụng nó làm danh tính tác nhân — vị trí số 1 trong lời nhắc hệ thống. Điều này có nghĩa là SOUL.md thay thế hoàn toàn văn bản nhận dạng mặc định được tích hợp sẵn.
Nếu SOUL.md bị thiếu, trống hoặc không thể tải được, Hermes sẽ quay trở lại danh tính mặc định được tích hợp sẵn.
Không có ngôn ngữ bao bọc nào được thêm vào xung quanh tệp. Bản thân nội dung rất quan trọng - hãy viết theo cách bạn muốn người đại diện của mình suy nghĩ và nói.
Một bản chỉnh sửa đầu tiên tốt
Nếu bạn không làm gì khác, hãy mở tệp và chỉ thay đổi một vài dòng để có cảm giác giống bạn.
Ví dụ:
You are direct, calm, and technically precise.
Prefer substance over politeness theater.
Push back clearly when an idea is weak.
Keep answers compact unless deeper detail is useful.
Chỉ điều đó thôi cũng có thể thay đổi đáng kể cảm giác của Hermes.
Kiểu ví dụ
1. Kỹ sư thực dụng
You are a pragmatic senior engineer.
You care more about correctness and operational reality than sounding impressive.
#
# Style
- Be direct
- Be concise unless complexity requires depth
- Say when something is a bad idea
- Prefer practical tradeoffs over idealized abstractions
#
# Avoid
- Sycophancy
- Hype language
- Overexplaining obvious things
2. Đối tác nghiên cứu
You are a thoughtful research collaborator.
You are curious, honest about uncertainty, and excited by unusual ideas.
#
# Style
- Explore possibilities without pretending certainty
- Distinguish speculation from evidence
- Ask clarifying questions when the idea space is underspecified
- Prefer conceptual depth over shallow completeness
3. Giáo viên/người giải thích
You are a patient technical teacher.
You care about understanding, not performance.
#
# Style
- Explain clearly
- Use examples when they help
- Do not assume prior knowledge unless the user signals it
- Build from intuition to details
4. Người đánh giá khó tính
You are a rigorous reviewer.
You are fair, but you do not soften important criticism.
#
# Style
- Point out weak assumptions directly
- Prioritize correctness over harmony
- Be explicit about risks and tradeoffs
- Prefer blunt clarity to vague diplomacy
Điều gì tạo nên một SOUL.md mạnh mẽ?
SOUL.md mạnh là:
- ổn định
- Áp dụng rộng rãi
- giọng nói cụ thể
- không bị quá tải với các hướng dẫn tạm thời
SOUL.md yếu là:
- đầy đủ thông tin dự án
- mâu thuẫn
- cố gắng quản lý vi mô mọi hình thức phản hồi
- chủ yếu là những từ bổ sung chung chung như "hữu ích" và "rõ ràng"
Hermes đã cố gắng tỏ ra hữu ích và rõ ràng. SOUL.md nên thêm cá tính và phong cách thực sự chứ không phải đặt lại các giá trị mặc định rõ ràng.
Cấu trúc đề xuấtBạn không cần tiêu đề, nhưng chúng sẽ giúp ích.
Một cấu trúc đơn giản hoạt động tốt:
# Identity
Who Hermes is.
# Style
How Hermes should sound.
# Avoid
What Hermes should not do.
# Defaults
How Hermes should behave when ambiguity appears.
SOUL.md vs /personality
Đây là những bổ sung.
Sử dụng SOUL.md cho đường cơ sở bền bỉ của bạn.
Sử dụng /personality để chuyển đổi chế độ tạm thời.
Ví dụ:
- LINH HỒN mặc định của bạn là thực dụng và trực tiếp
- sau đó trong một phiên bạn sử dụng
/personality teacher - sau đó bạn chuyển lại mà không thay đổi tập tin giọng nói cơ bản của mình
SOUL.md vs ĐẠI LÝ.md
Đây là sai lầm phổ biến nhất.
Đặt cái này vào SOUL.md
- “Trực tiếp đi.”
- “Tránh ngôn ngữ cường điệu.”
- “Thích câu trả lời ngắn trừ khi có chiều sâu.”
- “Đẩy lùi khi người dùng sai.”
Đặt cái này vào AGENTS.md
- “Sử dụng pytest, không phải unittest.”
- “Frontend sống ở
frontend/.” - "Không bao giờ chỉnh sửa di chuyển trực tiếp."
- “API chạy trên cổng 8000.”
Cách chỉnh sửa
nano ~/.hermes/SOUL.md
hoặc
vim ~/.hermes/SOUL.md
Sau đó khởi động lại Hermes hoặc bắt đầu một phiên mới.
Quy trình làm việc thực tế
- Bắt đầu với file mặc định đã được gieo hạt
- Cắt bớt bất cứ thứ gì không giống giọng nói bạn muốn
- Thêm 4–8 dòng xác định rõ ràng tông màu và giá trị mặc định
- Nói chuyện với Hermes một lúc
- Điều chỉnh dựa trên những gì vẫn còn cảm thấy chưa ổn
Cách tiếp cận lặp đi lặp lại đó hiệu quả hơn là cố gắng thiết kế tính cách hoàn hảo chỉ trong một lần chụp.
Khắc phục sự cố
Mình đã sửa SOUL.md nhưng Hermes vẫn nghe như vậy
Kiểm tra:
- bạn đã chỉnh sửa
~/.hermes/SOUL.mdhoặc$HERMES_HOME/SOUL.md - không phải một số kho lưu trữ cục bộ
SOUL.md - tập tin không trống
- phiên của bạn đã được khởi động lại sau khi chỉnh sửa
- lớp phủ
/personalitykhông chiếm ưu thế trong kết quả
Hermes đang bỏ qua các phần SOUL.md của tôi
Nguyên nhân có thể:
- hướng dẫn ưu tiên cao hơn đang ghi đè nó
- tập tin bao gồm hướng dẫn xung đột
- tập tin quá dài và bị cắt bớt
- một số văn bản giống với nội dung được nhắc nhở và có thể bị máy quét chặn hoặc thay đổi
SOUL.md của tôi trở nên quá cụ thể theo dự án
Chuyển hướng dẫn dự án vào AGENTS.md và giữ SOUL.md tập trung vào bản sắc và phong cách.