Hermes Agentの最初の1週間：メモリの整理、スキル、ツールの承認

Hermesを新しく入れたときの失敗は、予測できます。すべてのツールセットを有効にし、忙しいメッセージングチャネルにつなぎ、メモリを雑音で埋め、なぜエージェントが「おかしなことをした」のかと首をひねるパターンです。最初の1週間は、意図して退屈なくらいで構いません。欲しいのは、動くゲートウェイ、小さく整理したメモリ、存在意義のあるスキル1つ、制限したファイル書き込み、無効化または隔離され、承認と拒否を確認済みのターミナルです。

このガイドは、Hermesが何かをすでに知っている前提です（/articles/hermes-agent-what-it-is）。OSに合った公式のクイックスタートとインストールガイドを使ってください。コマンドやUIラベルは変わるので、入れる当日のドキュメントで確認します。

初日から本番のメール、CRMへの書き込み権限、無制限のシェルをつながないでください。ローカルか使い捨てのプロファイルで始め、主に読み取りのツールを使います。外部送信とシェルは無効にするか、ターミナルを隔離し、承認と拒否の動きを使う前に確認してください。

0～1日目：インストール、診断、スモークテスト

1. CLI、Docker、Desktopなど、公式のインストールガイドに書かれた経路で入れます。
2. すでに使っているモデルプロバイダーか、ローカルのOpenAI互換エンドポイントを設定します。Hermesは現在、ツールを使うエージェント向けに最低64,000トークンのコンテキストを求めます。URLが応答することだけでなく、モデルサーバー側のコンテキストウィンドウとツール呼び出し設定を確認してください（プロバイダードキュメント）。
3. hermes doctorを実行し、出力を見てください。コマンドがあること自体を、すべての連携が動く証拠にしてはいけません。
4. CLIでチャットセッションを1つ開きます。自分が管理する公開READMEの要約や、段落の下書きなど、無害な作業を頼みます。想定したツール呼び出しを確認し、不要なものは無効にします。

1日目の成功基準： セッションを開始でき、設定したモデルから返事があり、少なくとも64,000トークンのコンテキストが使えることを確認し、有効なツールを列挙できる。待受ソケットとバインドアドレスは別に確認します。「外部に待受がない」と言えるのは、有効なゲートウェイ、APIサーバー、webhook、ダッシュボード、モデルサーバーの面を無効にするか、意図したプライベートまたはループバックへバインドした場合だけです。

インストール方法、モデルのエンドポイント、有効なツールセット、ゲートウェイがローカル限定かどうかを短い実行ログに残してください。更新後に壊れたとき、そのログが何時間も節約します。

メモリの整理：USER.mdとMEMORY.mdに入れるもの

Hermesの組み込みメモリは上限があり、中身を選ぶ仕組みです。メモリのドキュメントでは、USER.mdとMEMORY.mdが~/.hermes/memories/に置かれること、セッション開始時に注入される固定スナップショット、追加・置換・削除を行うmemoryツールが説明されています。同時に動かす各エージェントには、個別のHermesホームまたはプロファイルを与えてください。2つのエージェントプロセスが同じホームへ書いてはいけません。メモリプロバイダーのドキュメントにある任意の外部プロバイダーは、組み込みメモリへの追加です。

USER.mdに入れるもの（安定した身元と好み）：

• どう呼ばれたいか、仕事で使う言語
• 既定の文体（単刀直入、前置きなし。必要ならエストニア語と英語の使い分け）
• 名前で使うツールとシステム（Linear、Notion、GitHub組織の略称）
• 厳守する制約（「コミットしない」「顧客にメールしない」「シェルの前に確認する」）

MEMORY.mdに入れるもの（長く効く作業上の事実）：

• 何か月も変わらないプロジェクト構成
• 繰り返し効くプロセスの癖（「このホストからステージングDBは読み取り専用」）
• エージェントが何度も間違える定義（重大度ラベル、製品名）

どちらにも入れないもの：

• APIキー、トークン、パスワード、リカバリーコード
• 顧客チケットの全文、人事メモ、健康の詳細、決済データ
• 一時的な雑音（「今日はアイデアXを試す」）
• 「メモリ」として貼ったチャット履歴の全文

メモリファイルは、共有ドライブと同じ規則が乗るデータストアとして扱ってください。請負業者がいるSlackチャネルに残したくない文章なら、エージェントにも残させないでください。ブリーフ全文をMEMORY.mdに貼るより、参照（「保管庫のノートClient-A-briefを見る」）を優先します。

週1回のメモリ確認（15分）

最初の1か月は、毎週金曜日に次を行います。

1. USER.mdとMEMORY.mdを開く。
2. 古くなったもの、細かすぎるものを消す。
3. 重複をまとめる。
4. ツールの意図しない書き込みでシークレットが入っていないか確認する。
5. 外部メモリプロバイダーを有効にしている場合は、そのプロバイダーが文書化している検索、エクスポート、削除、保持の機能で顧客データを確認する。十分な削除機能がなければ、顧客データを送らない。

メモリの質は運用作業です。怠ると、エージェントは古い事実を確信ありげに再利用します。

スキル：12個ではなく、まず1つ出す

スキルは手順の記憶です。SKILL.mdと、任意のスクリプトや参考資料を収めたディレクトリで、必要なときに読み込まれます。公式スキルドキュメントは、同梱、ハブ、エージェント作成のスキルを扱います。カタログやスキャナーが確認していても、外部スキルはすべてコードと指示として確認してください。

最初の1週間の原則： すでに毎週している仕事のために、スキルを1つ作ります。

「週次運用ブリーフ」用スキルの構成例：

# Skill: weekly-ops-brief

## When to use

User asks for the weekly ops brief or Monday status pack.

## Inputs required

- Date range
- Sources allowed (which channels/repos)
- Audience (internal only)

## Steps

1. List incidents and open P0/P1 items from the provided sources only.
2. Separate facts from inferences; mark inferences as [inference].
3. Draft under 400 words: What happened / What’s blocked / Decisions needed.
4. Do not send externally. Output markdown for human copy-paste.

## Stop rules

- If sources are missing, ask once, then produce a partial brief with gaps listed.
- Never invent metrics.

現行ドキュメントに従い、Hermesのスキルディレクトリへ保存します。入れたスキルは/<skill-name>で呼び出します。/skillsは管理と確認の面であり、一般の呼び出し構文ではありません（スラッシュコマンドのリファレンス）。2日目に、未確認のコミュニティスキルのマーケットプレイスを有効にしないでください。

コミュニティスキルは、シェルコマンドの実行や外部APIの呼び出しをエージェントに指示し得ます。インターネットのシェルスクリプトを読むつもりでSKILL.mdを読んでください。確認する習慣がつくまでは、自分で書いたスキルを優先します。

上流の書き込みゲートは明示的に有効にします。生成スキルにはskills.write_approval: true、メモリ変更にはmemory.write_approval: trueです。どちらもデフォルトはfalseです。現行の設定リファレンスで確認し、拒否された書き込みを1回テストして、承認待ちの状態を見てください。自動生成スキルは、人が確認して受け入れるまで下書きです。

ツール境界、承認、隔離：シェルは最後

Hermesには、Web、ターミナル、ファイル、ブラウザ、コード実行など幅広いツールセットがあります。文書化されたhermes toolsの面とツールドキュメントで設定します。

最初の1週間に推奨するツールの姿勢：

Hermesには、混ぜてはいけない3つのセキュリティ層があります。危険なコマンドの承認は、approvals.mode経由で印の付いたターミナルコマンドを制御します。manualが確認を求めるのは印の付いたコマンドであり、すべてのコマンドではありません。approvals.denyは、承認チェックが切れていても、設定したコマンドパターンを止めます。write_fileとpatchによる書き込みは、保護パスと任意のHERMES_WRITE_SAFE_ROOTを使います。書き込み承認の画面は出ず、同じユーザーのターミナルはこのファイルガードを迂回できます。Tirithは別の実行前コンテンツスキャナーで、利用できない場合はデフォルトで処理を通します。エージェントをホストから隔離する必要があるときは、Docker、Modalなどの文書化されたサンドボックスを使ってください（セキュリティドキュメント、MCPドキュメント）。

最初の1週間の実務的な承認方針です。

• 意図して許可： どのツールやパスが範囲外へ出られるかを確認したうえで、指定したプロジェクトディレクトリ内の読み取り専用の調査。
• 確認または拒否： 破壊的な削除、パッケージ導入、遠隔への書き込みなど、印の付いたターミナルコマンド。force-pushやpipe-to-shellなど、恒久的に禁じるパターンはapprovals.denyへ。文章だけでは強制できません。
• 無人では決して許可しない： 本番デプロイ、顧客へのメール送信、決済または本人確認システムの操作。該当ツールと認証情報を外すか、人が制御する別サービスの向こうへ隔離する。

これに、/articles/human-in-the-loop-design-patternsの人をループに入れる型と、/articles/connecting-ai-safelyの接続の安全を組み合わせてください。

メッセージングゲートウェイ：CLI経路が退屈になるまで待つ

次を満たすまで、Hermesを会社のSlack／Telegramチャネルに置かないでください。

1. メモリファイルを一度確認した。
2. CLIでスキルが1つ動く。
3. ターミナルを無効化または隔離し、承認と拒否の動きを確認した。
4. プラットフォーム固有の許可リストまたはDMペアリングを試した。メッセージングゲートウェイは不明ユーザーをデフォルトで拒否する一方、管理者と一般ユーザーのコマンド範囲は別に確認が必要です（メッセージングドキュメント）。

4日目の、自分宛ての非公開DMは妥当な試験です。公開のチームチャネルは、2週目以降の判断です。

愛着が湧く前にバックアップする

公式CLIにはhermes backupとhermes importがあります。バックアップには.env、認証材料、設定、セッションなどの機微な状態が入り得るので、アーカイブを認証情報ストアと同じように守ってください。インポート前にゲートウェイを止めます。hermes importは対象のHermesホーム内のファイルを上書きします。プロファイルへ依存する前に、隔離した検証用ホームへインポートし、期待した状態を確認してください。アーカイブが復元できると決めつけないことです（CLIリファレンス）。

演習：最初の1週間の受け入れチェックリスト

このチェックリストを印刷するか貼ります。すべての箱に印が付くまで、ツールのアクセスを広げないでください。

• インストールとモデルのスモークテストが終わり、少なくとも64,000トークンのコンテキストを確認し、実行ログを保存した
• 有効なリスナーとバインドアドレスを調べ、意図しない公開面がないことを確認した
• USER.mdには好みと厳守する制約だけがある
• MEMORY.mdは意図して小さい（長く効く事実20件を初期の予算とし、見直しのきっかけにする方法も実用的）；シークレットなし、顧客の個人情報のまとめなし
• カスタムスキルが1つあり、正常に呼び出せた（演習では意図して範囲を小さくしている）
• スキル書き込みとメモリ書き込みの承認を有効にしたか、対応する書き込みを無効にした
• 該当する場合、ファイルの安全なルート、ターミナルのツールセット、approvals.mode、拒否ルール、サンドボックスを試した
• 禁じたターミナル操作またはファイル操作を少なくとも1つ拒否させ、ディスク上で確認した
• 本番の送信／書き込み連携はつながっていない
• 機微なバックアップを取り、ゲートウェイを止め、検証用Hermesホームへのインポートを1回試した
• メッセージングは非公開の試験面に限っている（またはまだCLIだけ）

7日後の「完了」の姿

チェックリストを終えると、整理したメモリ、確認済みの手順1つ、リポジトリとメッセージングへの書き込みを拒否する経路をローカルで試したHermesプロファイルができます。これらの制御はリスクを下げます。設定不備を悪用できないことや、有害なツール呼び出しをしないことまでは証明しません。自律化は、運用記録を残し、拒否試験を繰り返し、2つ目のスキルも確認を通してからです。この記事が示すのは試験計画であり、今回の確認ではこれらの制御は実行していません。

次は、webhookによるイベント駆動の実行（/articles/hermes-webhooks-for-event-driven-agents）と、配管をn8nに残す場合（/articles/hermes-vs-n8n-choose-by-job）です。