🏠 Главная › Документация › Разработчикам

Сборка промпта

Hermes намеренно разделяет:

Это одно из важнейших архитектурных решений в проекте, поскольку оно влияет на:

Основные файлы:

Слои кэшированного системного промпта

Кэшированный системный промпт собирается примерно в таком порядке:

  1. идентичность агента — SOUL.md из HERMES_HOME при наличии, иначе используется DEFAULT_AGENT_IDENTITY из prompt_builder.py

  2. руководство по поведению с учётом инструментов

  3. статический блок Honcho (когда активен)

  4. опциональное системное сообщение

  5. замороженный снимок MEMORY

  6. замороженный снимок профиля USER

  7. индекс навыков

  8. контекстные файлы (AGENTS.md, .cursorrules, .cursor/rules/*.mdc) — SOUL.md не включается сюда, если уже был загружен как идентичность на шаге 1

  9. метка времени / опциональный ID сессии

  10. p>подсказка платформы

Когда установлен флаг skip_context_files (например, при делегировании сабагенту), SOUL.md не загружается, и вместо него используется жёстко заданный DEFAULT_AGENT_IDENTITY.

Конкретный пример: собранный системный промпт

Вот упрощённый вид финального системного промпта, когда присутствуют все слои (комментарии показывают источник каждого раздела):

# Layer 1: Agent Identity (from ~/.hermes/SOUL.md)
You are Hermes, an AI assistant created by Nous Research.
You are an expert software engineer and researcher.
You value correctness, clarity, and efficiency.
...

# Layer 2: Tool-aware behavior guidance
You have persistent memory across sessions. Save durable facts using
the memory tool: user preferences, environment details, tool quirks,
and stable conventions. Memory is injected into every turn, so keep
it compact and focused on facts that will still matter later.
...
When the user references something from a past conversation or you
suspect relevant cross-session context exists, use session_search
to recall it before asking them to repeat themselves.

# Tool-use enforcement (for GPT/Codex models only)
You MUST use your tools to take action — do not describe what you
would do or plan to do without actually doing it.
...

# Layer 3: Honcho static block (when active)
[Honcho personality/context data]

# Layer 4: Optional system message (from config or API)
[User-configured system message override]

# Layer 5: Frozen MEMORY snapshot
## Persistent Memory

- User prefers Python 3.12, uses pyproject.toml

- Default editor is nvim

- Working on project "atlas" in ~/code/atlas

- Timezone: US/Pacific

# Layer 6: Frozen USER profile snapshot
## User Profile

- Name: Alice

- GitHub: alice-dev

# Layer 7: Skills index
## Skills (mandatory)
Before replying, scan the skills below. If one clearly matches
your task, load it with skill_view(name) and follow its instructions.
...
<available_skills>
  software-development:
    - code-review: Structured code review workflow
    - test-driven-development: TDD methodology
  research:
    - arxiv: Search and summarize arXiv papers
</available_skills>

# Layer 8: Context files (from project directory)
# Project Context
The following project context files have been loaded and should be followed:

## AGENTS.md
This is the atlas project. Use pytest for testing. The main
entry point is src/atlas/main.py. Always run `make lint` before
committing.

# Layer 9: Timestamp + session
Current time: 2026-03-30T14:30:00-07:00
Session: abc123

# Layer 10: Platform hint
You are a CLI AI Agent. Try not to use markdown but simple text
renderable inside a terminal.

Как SOUL.md отображается в промпте

SOUL.md находится в ~/.hermes/SOUL.md и служит идентичностью агента — самым первым разделом системного промпта. Логика загрузки в prompt_builder.py работает следующим образом:

# From agent/prompt_builder.py (simplified)
def load_soul_md() -> Optional[str]:
    soul_path = get_hermes_home() / "SOUL.md"
    if not soul_path.exists():
        return None
    content = soul_path.read_text(encoding="utf-8").strip()
    content = _scan_context_content(content, "SOUL.md")  # Security scan
    content = _truncate_content(content, "SOUL.md")       # Cap at 20k chars
    return content

Когда load_soul_md() возвращает содержимое, оно заменяет жёстко заданный DEFAULT_AGENT_IDENTITY. Функция build_context_files_prompt() затем вызывается с skip_soul=True, чтобы предотвратить появление SOUL.md дважды (один раз как идентичность, второй раз как контекстный файл).

Если SOUL.md не существует, система возвращается к:

You are Hermes Agent, an intelligent AI assistant created by Nous Research.
You are helpful, knowledgeable, and direct. You assist users with a wide
range of tasks including answering questions, writing and editing code,
analyzing information, creative work, and executing actions via your tools.
You communicate clearly, admit uncertainty when appropriate, and prioritize
being genuinely useful over being verbose unless otherwise directed below.
Be targeted and efficient in your exploration and investigations.

Как внедряются контекстные файлы

build_context_files_prompt() использует приоритетную систему — загружается только один тип проектного контекста (первый подходящий):

# From agent/prompt_builder.py (simplified)
def build_context_files_prompt(cwd=None, skip_soul=False):
    cwd_path = Path(cwd).resolve()

    # Priority: first match wins — only ONE project context loaded
    project_context = (
        _load_hermes_md(cwd_path)       # 1. .hermes.md / HERMES.md (walks to git root)
        or _load_agents_md(cwd_path)    # 2. AGENTS.md (cwd only)
        or _load_claude_md(cwd_path)    # 3. CLAUDE.md (cwd only)
        or _load_cursorrules(cwd_path)  # 4. .cursorrules / .cursor/rules/*.mdc
    )

    sections = []
    if project_context:
        sections.append(project_context)

    # SOUL.md from HERMES_HOME (independent of project context)
    if not skip_soul:
        soul_content = load_soul_md()
        if soul_content:
            sections.append(soul_content)

    if not sections:
        return ""

    return (
        "# Project Context\\n\\n"
        "The following project context files have been loaded "
        "and should be followed:\\n\\n"
        + "\\n".join(sections)
    )

Детали обнаружения контекстных файлов

Приоритет Файлы Область поиска Примечания
1 .hermes.md, HERMES.md Текущая директория до корня git Конфигурация проекта, родная для Hermes
2 AGENTS.md Только текущая директория Общий файл инструкций агента
3 CLAUDE.md Только текущая директория Совместимость с Claude Code
4 .cursorrules, .cursor/rules/*.mdc Только текущая директория Совместимость с Cursor

Все контекстные файлы:

Слои, добавляемые только при вызове API

Эти элементы намеренно не сохраняются как часть кэшированного системного промпта:

Это разделение сохраняет стабильный префикс стабильным для кэширования.

Снимки памяти

Локальная память и данные профиля пользователя внедряются как замороженные снимки при запуске сессии. Записи в середине сессии обновляют состояние на диске, но не изменяют уже собранный системный промпт до начала новой сессии или принудительной пересборки.

Контекстные файлы

agent/prompt_builder.py сканирует и санирует файлы проектного контекста, используя приоритетную систему — загружается только один тип (первый подходящий):

  1. .hermes.md / HERMES.md (поиск до корня git)

  2. AGENTS.md (текущая директория при запуске; поддиректории обнаруживаются постепенно во время сессии через agent/subdirectory_hints.py)

  3. CLAUDE.md (только текущая директория)

  4. .cursorrules / .cursor/rules/*.mdc (только текущая директория)

SOUL.md загружается отдельно через load_soul_md() для слоя идентичности. Если он загружен успешно, build_context_files_prompt(skip_soul=True) предотвращает его дублирование.

Длинные файлы обрезаются перед внедрением.

Индекс навыков

Система навыков добавляет компактный индекс навыков в промпт, когда инструментарий навыков доступен.

Поддерживаемые способы настройки промпта

Большинству пользователей следует рассматривать agent/prompt_builder.py как внутреннюю реализацию, а не поверхность для настройки. Рекомендуемый путь кастомизации — изменять входные данные, которые Hermes уже загружает, вместо редактирования шаблонов Python.

Используйте эти способы в первую очередь

Когда вместо этого редактировать код

Редактируйте agent/prompt_builder.py только если вы намеренно поддерживаете форк или вносите изменения в поведение для апстрима. Этот файл собирает всю инфраструктуру промпта, границы кэша и порядок внедрения для каждой сессии. Прямые правки там — это глобальные изменения продукта, а не настройка промпта для конкретного пользователя.

Иными словами:

Почему сборка промпта разделена именно так

Архитектура намеренно оптимизирована для того, чтобы: