Hermes で SOUL.md を使う
目次
- SOUL.md に書くこと
- SOUL.md に書かないこと
- 置き場所
- 初回起動時の動き
- Hermes はこれをどう使うか
- 最初の一手
- 文体の例
- 1. 現実的なエンジニア
- 2. 研究のパートナー
- 3. 教える人・説明する人
- 4. 厳しいレビュアー
- よい SOUL.md とは
- 構成の案
- SOUL.md と /personality
- SOUL.md と AGENTS.md
- SOUL.md に書くもの
- AGENTS.md に書くもの
- 編集の仕方
- 実際の進め方
- トラブルシューティング
- SOUL.md を編集したのに Hermes の話し方が変わらない
- SOUL.md の一部が無視されている
- SOUL.md がプロジェクト寄りになりすぎた
- 関連ドキュメント
SOUL.md は、その Hermes に与える中心となる人格です。システムプロンプトのいちばん先頭に置かれ、エージェントが何者で、どう話し、何を避けるのかを決めます。
話しかけるたびに同じ相手だと感じられるようにしたい場合や、Hermes の人格をまるごと自分好みのものに置き換えたい場合は、このファイルを使います。
SOUL.md に書くこと
SOUL.md は次のために使います。
- 口調
- 人格
- 話し方
- Hermes をどれくらい率直に、あるいは温かくするか
- 文体として Hermes に避けてほしいこと
- 不確かさ・意見の相違・曖昧さに Hermes がどう向き合うか
ひとことで言えば、
SOUL.mdは Hermes が何者で、どう話すかを決めるものです
SOUL.md に書かないこと
次のような用途には使わないでください。
- リポジトリ固有のコーディング規約
- ファイルのパス
- コマンド
- サービスのポート番号
- アーキテクチャに関するメモ
- プロジェクトの進め方の指示
これらは AGENTS.md に書くものです。
目安はこうです。
- どこでも当てはまる内容なら
SOUL.mdに置く - 特定のプロジェクトにしか当てはまらない内容なら
AGENTS.mdに置く
置き場所
Hermes は現在、そのインスタンスのグローバルな SOUL ファイルだけを使います。
~/.hermes/SOUL.mdホームディレクトリを変えて Hermes を動かしている場合は、次の場所になります。
$HERMES_HOME/SOUL.md初回起動時の動き
SOUL.md がまだ無ければ、Hermes が出発点となるファイルを自動で用意します。
そのため、ほとんどの人は最初から、読んですぐ編集できる実物のファイルを手にすることになります。
注意すべき点は次のとおりです。
- すでに
SOUL.mdがある場合、Hermes がそれを上書きすることはありません - ファイルはあるが中身が空の場合、そこからプロンプトに加わるものは何もありません
Hermes はこれをどう使うか
セッションを開始すると、Hermes は HERMES_HOME から SOUL.md を読み込み、プロンプトインジェクションのパターンが無いか調べ、必要なら切り詰めたうえで、エージェントの人格（システムプロンプトの 1 番目の枠）として使います。つまり SOUL.md は、組み込みの既定の人格の文面をそっくり置き換えます。
SOUL.md が無い、空である、あるいは読み込めない場合、Hermes は組み込みの既定の人格に戻ります。
ファイルの周りに説明的な文言が足されることはありません。中身そのものがすべてです。エージェントにこう考えてこう話してほしい、という形で書いてください。
最初の一手
ほかに何もしないとしても、ファイルを開いて数行だけ自分らしく書き換えてみてください。
たとえば次のように書きます。
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.これだけでも、Hermes の印象ははっきり変わります。
文体の例
1. 現実的なエンジニア
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 things2. 研究のパートナー
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 completeness3. 教える人・説明する人
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 details4. 厳しいレビュアー
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よい SOUL.md とは
よい SOUL.md は次のようなものです。
- 安定している
- 幅広く当てはまる
- 声の特徴がはっきりしている
- 一時的な指示を詰め込みすぎていない
よくない SOUL.md は次のようなものです。
- プロジェクトの詳細だらけ
- 内容が矛盾している
- 応答の形を一つひとつ細かく指図しようとしている
- 「助けになること」「明確であること」のような、当たり障りのない文言ばかり
Hermes はもともと、助けになるように、明確であるように振る舞います。SOUL.md には、当たり前の既定を言い直すのではなく、本当の意味での人格や文体を足してください。
構成の案
見出しは必須ではありませんが、あると整理しやすくなります。
うまく機能する単純な構成は次のとおりです。
# 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 と /personality
この 2 つは補い合う関係です。
普段の土台となる人格には SOUL.md を使います。 一時的にモードを切り替えたいときは /personality を使います。
たとえば次のような形です。
- 既定の SOUL は現実的で率直な人格にしておく
- あるセッションだけ
/personality teacherを使う - あとで元に戻す。土台となる声のファイルには手を触れない
SOUL.md と AGENTS.md
いちばんよくある取り違えがここです。
SOUL.md に書くもの
- 「率直に述べること。」
- 「大げさな言い回しを避けること。」
- 「深く掘り下げる必要がなければ短く答えること。」
- 「利用者が間違っているときは指摘すること。」
AGENTS.md に書くもの
- 「unittest ではなく pytest を使うこと。」
- 「フロントエンドは
frontend/にある。」 - 「マイグレーションを直接編集しないこと。」
- 「API はポート 8000 で動いている。」
編集の仕方
nano ~/.hermes/SOUL.mdまたは
vim ~/.hermes/SOUL.md編集したら Hermes を再起動するか、新しいセッションを開始します。
実際の進め方
- 自動で用意された既定のファイルから始める
- 求めている声と合わない部分を削る
- 口調と既定の振る舞いをはっきり決める行を 4〜8 行足す
- しばらく Hermes と話してみる
- しっくり来ないところを調整する
一発で完璧な人格を設計しようとするより、この繰り返しのほうがうまくいきます。
トラブルシューティング
SOUL.md を編集したのに Hermes の話し方が変わらない
次を確認してください。
- 編集したのが
~/.hermes/SOUL.mdまたは$HERMES_HOME/SOUL.mdであること - リポジトリの中にある別の
SOUL.mdを触っていないこと - ファイルが空でないこと
- 編集後にセッションを開始し直したこと
/personalityの重ね掛けが結果を支配していないこと
SOUL.md の一部が無視されている
考えられる原因は次のとおりです。
- 優先度の高い指示に上書きされている
- ファイルの中で指示どうしが食い違っている
- ファイルが長すぎて切り詰められた
- 一部の文がプロンプトインジェクションの内容に似ており、検査によって遮断・変更された
SOUL.md がプロジェクト寄りになりすぎた
プロジェクト向けの指示は AGENTS.md に移し、SOUL.md は人格と文体に絞ってください。