Hermes エージェント入門 : パーソナリティ & SOUL.md

Posted on by Masashi Okumura

Hermes エージェントのパーソナリティは完全にカスタマイズ可能です。SOUL.md は 主要なアイデンティティ です – システムプロンプトの最初に存在し、エージェントのアイデンティティを定義します。

Hermes エージェント☤ 入門 : 機能 – コア : パーソナリティ & SOUL.md

作成 : Masashi Okumura (@classcat.com)
作成日時 : 08/31/2026
バージョン : Hermes Agent v0.20.6 (v2026.8.27)

* 本記事は hermes-agent.nousresearch.com/docs の以下のページを参考にしています :

* サンプルコードの動作確認はしておりますが、必要な場合には適宜、追加改変しています。

 

 

Hermes エージェント☤ 入門 : 機能 – コア : パーソナリティ & SOUL.md

Hermes エージェントのパーソナリティは完全にカスタマイズ可能です。SOUL.md は 主要なアイデンティティ です – システムプロンプトの最初に存在し、エージェントのアイデンティティを定義します。

  • SOUL.md ― HERMES_HOME フォルダに在る永続的なペルソナファイルで、エージェントのアイデンティティ (システムプロンプトのスロット #1) として機能します。

  • 組み込みまたはカスタムの `/personality` プリセット ― セッションレベルのシステムプロンプト・オーバーレイ

Hermes のアイデンティティを変更したい場合 – または全く別のエージェントのペルソナに置き換えたい場合 – SOUL.md を編集してください。

 

How SOUL.md works now

Hermes は、以下の場所にデフォルトの SOUL.md を自動的に初期設定します :

~/.hermes/SOUL.md

より正確には、現在のインスタンスの HERMES_HOME を使用するため、カスタムホームディレクトリで Hermes を実行する場合、次が使用されます :

$HERMES_HOME/SOUL.md

 

重要な動作

  • SOUL.md はエージェントの主要なアイデンティティです。システムプロンプトのスロット #1 を占め、ハードコードされたデフォルトのアイデンティティを置き換えます。

  • Hermes は、SOUL.md が存在しない場合、自動的にスターター SOUL.md を作成します。

  • 既存のユーザー SOUL.md ファイルは決して上書きされません。

  • Hermes は HERMES_HOME からのみ SOUL.md をロードします。

  • Hermes は現在の作業ディレクトリで SOUL.md を検索しません。

  • SOUL.md が存在するものの空であるか、ロードできない場合、Hermes は組み込みのデフォルトのアイデンティティにフォールバックします。

  • SOUL.md にコンテンツがある場合、そのコンテンツはセキュリティスキャンと切り詰め (truncation) 処理の後、そのまま注入されます。

  • SOUL.md はコンテキストファイルセクションで 重複しません – アイデンティティとして一度だけ出現します。

これにより、SOUL.md は単なる付加的なレイヤーではなく、真の意味でのユーザー単位またはインスタンス単位のアイデンティティとなります。

 

Why this design

これにより、パーソナリティの一貫性を保持できます (predictable)。

もし Hermes が起動時に指定したディレクトリから SOUL.md を読み込むと、プロジェクトごとにパーソナリティが予期せず変わってしまう可能性があります。HERMES_HOME ディレクトリからのみ読み込むことで、パーソナリティは Hermes インスタンス自体に固有のものとなります。

また、これによりユーザーへの説明も容易になります :

  • 「Hermes のデフォルトのパーソナリティを変更するには、~/.hermes/SOUL.mdを編集してください」

 

Where to edit it

For most users:

~/.hermes/SOUL.md

If you use a custom home:

$HERMES_HOME/SOUL.md

 

What should go in SOUL.md?

以下のような、永続的な口調 (voice) とパーソナリティのガイダンスとして活用してください :

  • トーン

  • コミュニケーションスタイル

  • ストレートさ (directness) の度合い

  • デフォルトのインタラクション・スタイル

  • 避けるべきスタイル

  • ヘルメスが不確実性、意見の相違、曖昧さにどのように対処すべきか

 
以下の用途には適しません (Use it less for) :

  • 単発プロジェクトの指示

  • ファイルパス

  • リポジトリの規約

  • 一時的なワークフローの詳細

Those belong in AGENTS.md, not SOUL.md.

 

優れた SOUL.md コンテンツ

優れた SOUL ファイルとは :

  • コンテキスト間で安定している

  • 多くの会話に適用できるほど汎用性が高い

  • 口調を具体的に形成できるほど具体的である

  • タスク固有の指示ではなく、コミュニケーションとアイデンティティに焦点を当てている

 

Example

# Personality

You are a pragmatic senior engineer with strong taste.
You optimize for truth, clarity, and usefulness over politeness theater.

## Style
- Be direct without being cold
- Prefer substance over filler
- Push back when something is a bad idea
- Admit uncertainty plainly
- Keep explanations compact unless depth is useful

## What to avoid
- Sycophancy
- Hype language
- Repeating the user's framing if it's wrong
- Overexplaining obvious things

## Technical posture
- Prefer simple systems over clever systems
- Care about operational reality, not idealized architecture
- Treat edge cases as part of the design, not cleanup

 

Hermes がプロンプトに注入するもの

SOUL.md の内容は、システムプロンプトのスロット #1 – エージェントのアイデンティティの位置 – に直接注入されます。その周りにラッパー言語は追加されません。

コンテンツは以下の処理を経ます :

  • プロンプト注入スキャン

  • サイズが大きすぎる場合は切り詰め

ファイルが空、空白文字のみ、または読み取り不能な場合、Hermes は組み込みのデフォルトのアイデンティティ (“You are Hermes Agent, an intelligent AI assistant created by Nous Research…”) にフォールバックします。このフォールバックは、(e.g., subagent/delegation コンテキスト内に) skip_context_files が設定されている場合にも適用されます。

 

セキュリティスキャン

SOUL.mdは、他のコンテキスト付与ファイルと同様に、インクルード前にプロンプ​​ト注入パターンがないかスキャンされます。

つまり、不審なメタ指示をこっそり挿入しようとするのではなく、ペルソナ/口調 (voice) に焦点を当て続けるべきです。

 

以上