人格と SOUL.md

Hermes Agent の人格は、思いどおりに変えられます。SOUL.md は エージェントの中心にある人格 で、システムプロンプトの一番先頭に置かれ、エージェントが何者かを決めます。

SOUL.md — HERMES_HOME に置かれる、長く使うペルソナのファイル。エージェントの人格そのものになります（システムプロンプトのスロット #1）
組み込みまたは独自の /personality プリセット — セッション単位でシステムプロンプトに重ねる設定

Hermes の人となりを変えたいとき、あるいはまったく別のエージェントのペルソナに置き換えたいときは、SOUL.md を編集してください。

現在の SOUL.md のしくみ

Hermes は、既定の SOUL.md を次の場所に自動で作ります。

~/.hermes/SOUL.md

正確には、そのインスタンスの HERMES_HOME を使うので、カスタムのホームディレクトリで Hermes を動かしている場合は次の場所になります。

$HERMES_HOME/SOUL.md

押さえておきたい振る舞い

SOUL.md はエージェントの中心にある人格です。 システムプロンプトのスロット #1 を占め、組み込みの既定の人格に取って代わります。
SOUL.md がまだ無ければ、Hermes が出発点となるファイルを自動で作ります
すでにある利用者の SOUL.md が上書きされることはありません
Hermes は SOUL.md を HERMES_HOME からのみ読み込みます
Hermes はカレントディレクトリの SOUL.md を探しません
SOUL.md があっても中身が空、あるいは読み込めない場合、Hermes は組み込みの既定の人格に戻ります
SOUL.md に中身があれば、セキュリティ検査と切り詰めを経たうえでそのまま差し込まれます
SOUL.md はコンテキストファイルの節には 重複して現れません — 人格として 1 回だけ現れます

これにより SOUL.md は、単に上へ重ねるだけの層ではなく、利用者ごと・インスタンスごとの本当の人格になります。

この設計にした理由

こうすることで、人格が予想どおりに保たれます。

もし Hermes が、起動したディレクトリの SOUL.md を読み込むようになっていたら、プロジェクトを移るたびに人格が思わぬ形で変わってしまいます。HERMES_HOME からだけ読み込むことで、人格は Hermes インスタンス自身のものになります。

説明もしやすくなります。

「Hermes の既定の人格を変えたいなら ~/.hermes/SOUL.md を編集する」

どこを編集するか

ほとんどの場合は次の場所です。

~/.hermes/SOUL.md

カスタムのホームを使っている場合は次の場所です。

$HERMES_HOME/SOUL.md

SOUL.md には何を書くか

長く使う声や人格の指針を書きます。たとえば次のようなものです。

話し方の調子
伝え方
どれくらい率直にするか
ふだんのやり取りの姿勢
文体として避けたいこと
不確かなこと、意見の食い違い、あいまいさにどう向き合うか

次のような用途には向きません。

その場かぎりのプロジェクトへの指示
ファイルのパス
リポジトリの規約
一時的な作業手順

これらは SOUL.md ではなく AGENTS.md に書いてください。

よい SOUL.md の中身

よい SOUL ファイルは次のようなものです。

場面が変わっても変わらない
多くの会話に当てはまる程度に幅がある
声を実際に形づくる程度に具体的である
個別の作業への指示ではなく、伝え方と人格に集中している

例

# 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...」）に戻ります。この動きは skip_context_files が設定されているとき（サブエージェントや委任の場面など）にも当てはまります。

セキュリティ検査

SOUL.md も、ほかのコンテキストを持つファイルと同じように、取り込まれる前にプロンプトインジェクションのパターンがないか検査されます。

ですから、妙なメタ指示を紛れ込ませようとするのではなく、あくまでペルソナと声に集中した内容にしておいてください。

SOUL.md と AGENTS.md の違い

これがいちばん大事な区別です。

SOUL.md

次のことに使います。

人格
話し方の調子
文体
ふだんの伝え方
人格のレベルでの振る舞い

AGENTS.md

次のことに使います。

プロジェクトのアーキテクチャ
コーディング規約
好みのツール
リポジトリ固有の作業手順
コマンド、ポート、パス、デプロイの注意点

わかりやすい目安は次のとおりです。

どこへ行っても付いてきてほしいものは SOUL.md
プロジェクトに属するものは AGENTS.md

SOUL.md と `/personality` の違い

SOUL.md は、長く使う既定の人格です。

/personality は、いまのシステムプロンプトを変えたり補ったりする、セッション単位の重ね書きです。

まとめると次のようになります。

SOUL.md = 土台となる声
/personality = 一時的なモードの切り替え

例:

ふだんは実務的な SOUL のまま、指導する会話のときだけ /personality teacher を使う
簡潔な SOUL のまま、発想を広げたいときだけ /personality creative を使う

組み込みの人格

Hermes には、/personality で切り替えられる人格があらかじめ用意されています。

名前	説明
helpful	親しみやすい万能アシスタント
concise	短く要点だけを返す
technical	詳しく正確な技術の専門家
creative	型にとらわれない発想
teacher	わかりやすい例で辛抱強く教える
kawaii	かわいい言い回しときらめきと元気 ★
catgirl	猫っぽい話し方のねこちゃん、にゃ〜
pirate	技術に強い海賊、キャプテン Hermes
shakespeare	芝居がかった吟遊詩人ふうの文体
surfer	どこまでもゆるいサーファー気分
noir	ハードボイルドな探偵の語り
uwu	uwu 言葉でかわいさ全開
philosopher	どんな問いにも深く思索する
hype	エネルギーと熱狂を最大に!!!

コマンドで人格を切り替える

CLI

/personality
/personality concise
/personality technical

メッセージングのプラットフォーム

/personality teacher

これらは手軽に重ねられる設定ですが、重ねた内容が大きく変えないかぎり、Hermes のふだんの人格はグローバルな SOUL.md が決めたままです。

設定ファイルで人格を作る

組み込みの人格は、どの画面（CLI、メッセージングのプラットフォーム、TUI、デスクトップアプリ）でも常に使えます。自分で作った人格を加えることも、同じ名前を使って組み込みのものを上書きすることもできます。書き場所は ~/.hermes/config.yaml の agent.personalities です。

agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.

そのうえで、次のように切り替えます。

/personality codereviewer

選んだ内容は名前として display.personality に保存されます。人格が agent.system_prompt に触れることはありません。こちらは自分で書くシステムプロンプト専用の項目で、人格を何も選んでいないときにだけ効きます。

既定の状態に戻す

いま重ねている人格を取り消して、もとの振る舞い（SOUL.md のペルソナと、設定していれば agent.system_prompt）に戻すには、次のいずれかを使います。

/personality none
/personality default
/personality neutral

3 つとも選択（display.personality）を消し、次のメッセージから反映されます。引数なしで /personality を実行すると、使えるプリセットと並んで none も一覧に出て、いま有効なものに印が付きます。

人格とプロンプト全体の関係

大まかに言うと、プロンプトは次の順で積み上がっています。

SOUL.md（エージェントの人格。SOUL.md が使えない場合は組み込みの既定）
ツールを踏まえた振る舞いの指針
メモリと利用者のコンテキスト
スキルの指針
コンテキストファイル（AGENTS.md、.cursorrules）
タイムスタンプ
プラットフォームごとの書式のヒント
/personality などの、必要に応じたシステムプロンプトの重ね書き

SOUL.md が土台であり、それ以外はすべてその上に積み上がります。

CLI の見た目と会話の人格

会話の人格と CLI の見た目は別のものです。

SOUL.md、agent.system_prompt、/personality は Hermes の話し方に影響します
display.skin と /skin は、ターミナルでの Hermes の見た目に影響します

ターミナルの見た目については、スキンとテーマをご覧ください。