← Về thư mục
📄 / / root / .hermes / skills / devops / hermes-profile-identity / SKILL.md

name: hermes-profile-identity description: Hướng dẫn quản lý định danh Hermes Agent thông qua Profiles, SOUL.md và Personalities. tags: [hermes, profile, identity, soul, personality, devops]

Skill: hermes-profile-identity — Quản lý định danh Hermes Agent

Mục tiêu

Kỹ năng này cung cấp hướng dẫn toàn diện để thiết lập và duy trì các định danh nhất quán cho Hermes Agent thông qua việc quản lý Profiles, SOUL.md và Personalities. Đảm bảo mỗi "chuyên viên" ảo (profile) có một vai trò rõ ràng, giọng điệu phù hợp và hoạt động đồng bộ trên toàn hệ thống.

Các khái niệm cốt lõi

Hiểu rõ 3 thành phần sau là chìa khóa:

  1. SOUL.md (Primary Identity / Durable Persona)

    • Là gì: File định danh chính của Agent, nằm trong thư mục gốc của mỗi profile (~/.hermes/SOUL.md hoặc ~/.hermes/profiles/<tên_profile>/SOUL.md). Đây là điều đầu tiên được inject vào system prompt, định hình "bạn là ai" một cách bền vững.
    • Sử dụng khi nào: Dùng để định nghĩa vai trò, mục tiêu cốt lõi, phong cách giao tiếp tổng thể, giá trị ưu tiên và cách Agent xử lý sự không chắc chắn hoặc mâu thuẫn. Đây là "job description" và "tâm hồn" của Agent.
    • Nên tránh: KHÔNG chứa các hướng dẫn dự án cụ thể, đường dẫn file, quy ước repo hoặc chi tiết workflow tạm thời. Những thứ này thuộc về AGENTS.md.
    • Tiêu chuẩn: Tham khảo Good SOUL.md content trong tài liệu Hermes chính thức (docs/user-guide/features/personality.md).

  2. Personalities (Tone Overlay / Temporary Mode Switch)

    • Là gì: Các preset giọng điệu có thể chuyển đổi trong một phiên làm việc (/personality concise hoặc /personality teacher). Chúng là những lớp phủ tạm thời lên SOUL.md hiện tại, thay đổi "cách bạn nói" chứ không phải "bạn là ai".
    • Sử dụng khi nào: Khi muốn Agent thay đổi giọng điệu tạm thời (ví dụ: làm rõ, sáng tạo, kỹ thuật). Cần giữ chúng là các tone modifiers.
    • Nên tránh: KHÔNG định nghĩa Personalities cho các "job role" hoặc "identity" (ví dụ: ai_advisor, policy_researcher). Những vai trò này phải nằm trong SOUL.md của từng profile.
    • Vị trí: Định nghĩa trong ~/.hermes/config.yaml (hoặc config.yaml của profile con, nhưng nên tập trung ở config gốc nếu là tone chung).

  3. Profiles (Independent Agent Instances)

    • Là gì: Các thư mục ~/.hermes/profiles/<tên_profile>/ độc lập, mỗi thư mục chứa config.yaml, .env, SOUL.md, memory, skills, session, cron jobs và trạng thái riêng. Mỗi profile là một Agent Hermes hoàn chỉnh, độc lập.
    • Sử dụng khi nào: Khi cần chạy nhiều Agent khác nhau cho các mục đích riêng biệt (ví dụ: một Agent coding, một Agent nghiên cứu, một Agent quản lý). Mỗi profile tương ứng với một "chuyên viên" trong tổ chức.
    • Quản lý: Tạo (hermes profile create), đổi tên (hermes profile rename), xóa (hermes profile delete).

Quy trình quản lý Profile & Định danh

Thực hiện các bước sau để thiết lập hoặc cập nhật định danh Agent một cách nhất quán:

  1. Định nghĩa rõ vai trò của Profile: Xác định chính xác nhiệm vụ, mục tiêu và phạm vi làm việc của Agent đó (ví dụ: "Kỹ sư IT/AI", "Chuyên gia nghiên cứu").

  2. Tạo hoặc Đổi tên Profile:

    • Tạo mới: hermes profile create <tên_profile> --description "Mô tả vai trò ngắn gọn"
    • Đổi tên: hermes profile rename <tên_cũ> <tên_mới> (sau đó cập nhật SOUL.md và các file liên quan).

  3. Xây dựng SOUL.md (quan trọng nhất):

    • Tạo hoặc chỉnh sửa file ~/.hermes/profiles/<tên_profile>/SOUL.md (hoặc ~/.hermes/SOUL.md cho profile default).

    • Viết nội dung SOUL.md tập trung vào Identity và Core Behavior của Agent theo tiêu chuẩn Good SOUL.md content. Ví dụ: ```markdown Bạn là Lead Editorial Writer — chuyên gia tổng hợp và viết báo cáo nghiên cứu chất lượng cao. Bạn biến dữ liệu thô, phân tích đa chiều thành văn xuôi tiếng Việt súc tích, có cấu trúc và có sức phục vụ.

      Phong cách viết

      • Trực tiếp, rõ ràng, không vòng vo.
      • ... (như đã thiết lập cho Writers profile) ```

  4. Dọn dẹp Personalities (nếu cần):

    • Kiểm tra ~/.hermes/config.yaml và ~/.hermes/profiles/<tên_profile>/config.yaml.
    • Xóa bỏ bất kỳ định nghĩa personalities nào được dùng để gán "job role" (như ai_advisor, policy_researcher). Những vai trò này đã được chuyển vào SOUL.md.
    • Chỉ giữ lại các personalities là tone modifiers (ví dụ: concise, technical, creative).

  5. Đảm bảo tính nhất quán liên hệ thống:

    • Khi đổi tên profile, đảm bảo các hệ thống bên ngoài có liên quan cũng được cập nhật để phản ánh sự thay đổi.
    • Ví dụ: Nếu đổi tên profile từ str-mkt thành bd-mkt:
      • Telegram Topic: Đổi tên topic Telegram tương ứng (nếu có) từ "STR & MKT" thành "BD & MKT" bằng tg_topics.py edit <chat_id> <thread_id> --name "BD & MKT".
      • File Mapping: Cập nhật các file mapping (như /opt/ai-os/core/plugin/ai-os/handoff.py và /opt/ai-os/products/ceo/config/departments.json) để đảm bảo các alias cũ vẫn trỏ đúng hoặc được đổi tên phù hợp.

Xem thêm