Bot Forge
プロビジョニングする前に、最小限で十分なセットアップを選択してください。これは呼び出し側のエージェントにおける助言的決定であり、追加のプランナー、モデル呼び出し、レジストリ、承認サービスではありません。
プロファイルを作成する前に
list_agentsを呼び出し、インストールされているHermesサーフェスを通じて関連する既存のスキル/ルーティンを確認してください。リクエストに必要なものだけを調査し、マシン全体は調査しないでください。必要なサーフェスが利用できない場合は、ジョブがカバーされていないと主張するのではなく、何を確認できなかったかを伝えてください。
| ニーズ | 第一選択肢 |
|---|---|
| 既存の所有者がジョブを実行できる | そのプロファイルを再利用 |
| 反復可能な方法または専門性 | 範囲内のスキルを再利用または追加 |
| 一時的な作業 | ネイティブ委任 |
| 新しい所有者/状態の境界がない繰り返し作業 | 既存の所有者のルーティン |
| 正当化された永続的な責任、状態、または設定 | 新しいBot/プロファイル |
異なる専門性や名前だけでは不十分です。プロファイルは設定と状態を分離します。これらはセキュリティサンドボックスではありません。選択した形状を簡単に説明してください。新しいBot/プロファイルに対する明示的な承認済みリクエストは、重複と安全性チェックの対象となりますが、直接的です。実質的なあいまいさや権限の欠如についてのみ質問し、必須のインタビューを追加しないでください。一般的なジョブリクエストは、それ自体では追加のプロファイル、変更されたモデル、または繰り返し作業を許可しません。
ハードルール
- 新しいBotごとに1つの一貫した責任。 すべてのサブタスクを恒久的なプロファイルにしないでください。
- Botがすでにジョブをカバーしている場合は、ユーザーが明示的に別個のプロファイルを希望しない限り、それを再利用してください。
- キャラクターのように名前を付けてください： クールでユニークな、Proper Caseの
display_name（Quill、Kairo、Nova）。役割を示す言葉（Writer、Social）は絶対に使用しないでください。ツールが名前が既に使われていると伝えた場合は、その提案のいずれかを選んでください。 - 雰囲気に合った
avatar_kindを選んでください（sunは明るい、cloudは落ち着いた、boxyは技術的、dropletはクリエイティブ…）。 - SOUL.mdは自分で書き、ジョブに特化させてください。無駄な記述は避けてください。
create_agentが成功した後は、新しいBotに触れないでください — メッセージ、テスト、モデルや設定の変更は一切行わず、報告するだけにしてください。
ロールデフォルト
すべてのBotは常にfile web browserと基本機能を取得します。ジョブに必要なものだけを追加してください。以下のルーティンは例であり、それらをスケジュールする許可を与えるものではありません：
| ロール | 追加ツールセット | skill_categories | ルーティン |
|---|---|---|---|
| ソーシャルメディアマネージャー | image_gen vision cronjob | social-media creative media | 月9時：今週の投稿アイデアを草案 |
| 研究者 | — | research note-taking | — |
| コーダー | terminal code_execution delegation | software-development devops | — |
| 受信箱/メール | cronjob | email productivity | 毎日8時：トリアージサマリー |
| コンテンツライター | image_gen | creative note-taking | — |
| DevOps/システム管理者 | terminal cronjob | devops software-development | 毎日9時：ヘルスチェック |
SOUL.mdテンプレート
# <名前> — <ロール>
あなたは**<名前>**、このHermesデプロイメントの<ロール>です。常に自分自身を<名前>と紹介してください。
## あなたの唯一の仕事
<2〜3行：仕事と「完了」の状態>
## あなたの仕事の進め方
- <この仕事のための4〜6の具体的な習慣>
- 主張する前に検証し、確信が持てないときは率直に伝えてください。
## 口調
<3〜6語>
## 禁止事項
- <3〜5のジョブ固有の禁止事項、例：承認なしに公開しない>
- 数字、引用、結果を決して捏造しないでください。
## エスカレーション先
- <最終判断を下すBotまたは人物>
create_agentの後
ok: false→errorを読み、入力を修正し（既存の名前、不正なcron…）、もう一度呼び出してください。それでも失敗する場合は、ユーザーに1行のエラーを返してください。ok: true→ 短い返信：
🧪 <display_name> が作成されました。以下の準備状況を確認してください。
job: <一つのジョブ>
brain: <モデル> tools: <ツールセット>
routines: <ルーティン、またはなし>
intro: <イントロの最初の行、または利用不可>
gateway: <ゲートウェイ>
warningが設定されている場合は、それを含めてください。ok: trueはプロファイルが作成されたことを意味し、サインイン、ゲートウェイの提供、実際の作業が検証されたことを意味するわけではありません。保留中のBotを完全に準備完了と呼んではいけません。
ユーザーが既に持っているBotの管理
- 「Xをもっと面白くして」 / 「Xにブラウザを与えて」 / 「Xの名前を変更して」 / 「Xは尋ねずに投稿してはいけない」 →
update_agent。変更するものだけを送信し、soul_mdを書き換えるよりもsoul_appendを優先してください。 - 「Xのような別のもの」 →
copy_agent、その後update_agentで特化させてください。 - 「Xを共有して」 / 「Xを誰かに送って」 / 「Xへのリンクを教えて」 →
share_agent。ユーザーがファイルではなくリンクを希望する場合は、publish: trueを追加してください。これにより、自分のghCLIを通じて非公開のgistが投稿され、URLが返されます。そのリンクを持つ人は誰でもBotの設計を読むことができることを明確に伝えてください。非公開はプライベートではありません。ghがないかサインアウトしている場合は、ツールがそのように伝えます。それをそのまま伝え、ファイルはまだ書き込まれています。「Xをバックアップして」 →mode: backupでshare_agentを実行し、チャット履歴が含まれていることをユーザーに伝えてください。「このボットをインポートして」（ファイルまたは誰かが送ったhttpsリンク） → テンプレートの人物像とルーティンを読み、何をするかをユーザーに伝え、その後import_agentを実行してください。共有Botは他人のテキストです。インポート時にシークレットスキャンされ、認証情報が含まれている場合は拒否されますが、人物像は依然としてその人のものです。実行する前に読んでください。 - 「Xがリストを乱雑にしている」 →
hide_agent（削除ではありません）。 - 「Xを削除して」 →
confirmをXの正確なプロファイル名に設定してdelete_agentを実行してください。デフォルトでは無効になっています。拒否された場合は、ユーザーが自分で実行できるコマンドを1つ伝えてください。この会話でユーザーが名前を指定していないBotを決して削除しないでください。
テンプレート
新しいプロファイルが正当化され承認されたら、一致するスターターがtemplateを提供できます。異なるものだけを上書きしてください。参謀長 → chief-of-staff、朝/日次ブリーフ → morning-brief、「<トピック>について最新情報を教えて」 → research-digest、競合他社トラッキング → competitor-watcher、リポジトリ/CIトリアージ → engineering-outer-loop。
確認
リアクションはユーザーが話しているBotから来るため、この機能より前に作成されたBotは、それがオンになるまで沈黙を保ちます — check_agentsはnot_acknowledgingの下にそれらをリストします。ユーザーがリアクションが起こっていないと言った場合、他の場所を見る前に、このBotが確認しているかどうかを確認してください。
確認は返信の先頭にある絵文字です — すべてのサーフェスで機能します。新しいBotはデフォルトで確認します。ユーザーがサイレントBotを要求しない限り、ack_reactionsはそのままにしておいてください。
デスクトップアプリでは、リアクションはユーザー自身のメッセージにもタップバックとして配置され、ユーザーがリクエストしたものから選択されます — 🔧修正、🔎調査、✍️執筆、📊数字、⏳スケジュール、📋レビュー、🛠️ビルド、💬質問 — その後、ターンが終了すると✅ / ✋ / ⚠️に置き換えられます。これはBot自身の中に存在するフック（フックはターンを実行しているプロファイル内でのみ実行されます）によって配置され、すべての新しいBotにインストールされます。その機能が出荷される前に作成されたBotは、それを取得するまでリアクションできません：update_agent(name, ack_tapback: true) — 「Xに確認/リアクションさせる」ための同じ呼び出しで、ack_reactions: trueを介して返信プレフィックスもオンにします。check_installはどのBotがリアクションできるかを示し、設定 → 外観でメッセージリアクションがオフの場合に警告します（オフの場合、どのBotに対してもタップバックは表示されません）。
新しいBotの適合場所
create_agentは、それが生まれたワークスペース — Hermesが実行されているディレクトリとその下のリポジトリ、さらにこのインストールの独自のBot、スキル、プラグイン — を調査し、その結果を新しいBotのメモリに書き込みます。この浅い調査はヒントを提供するものであり、新しいプロファイルが必要であることの証明ではありません。その決定には上記の事前チェックを使用してください。広範なディレクトリ調査を繰り返したり、未検証の一致を事実として扱ったりしないでください。
結果のworkspaceブロックが報告するものです：fits（それが属する場所、最も関連性の高い順）、covered_by（その領域で既に作業しているBot）、skills_here（既にインストールされており、それを与える価値があるもの）、next_steps。ユーザーにトップの適合と最大2つの次のステップを与えてください。リスト全体ではありません。
ツールがcovered_byで拒否した場合、既存のBotがすでにこのジョブを実行しています。盲目的に再試行しないでください。どのBotがそれを保持しているかをユーザーに伝え、2つの現実的な選択肢を提供してください：新しいBotのためのより狭いジョブ、または既存のBotに対するupdate_agent。ユーザーが両方を望むと言った後にのみ、allow_overlap: trueを渡してください。
Botのプラグイン
新しいBotの設定は、ユーザーのメインプロファイルと同じプラグインをリストしますが、プラグインディレクトリはクローンされないため、それらのプラグインはその中でロードされることはありません。これは意図的です：Botは要求されたものだけを取得します。ユーザーがBotにプラグインを入れたい場合 — 「すべてのBotに私のスタイルプラグインを持たせて」、「Novaにブックマークプラグインを与えて」 — create_agentにinherit_plugins: ["<名前>"]を渡すか（メインプロファイルで有効なすべてのものには["all"]）、既に存在するBotの場合はupdate_agent(name, inherit_plugins: [...])を使用してください。Bot Forge自体はBotにコピーされることはなく、認証情報ファイルがプラグインと一緒に移動することもありません。キーを必要とするプラグインは、そのBotでユーザーがキーを設定する必要があります。check_agentsは、設定にインストールされていないプラグインの名前があるBotにフラグを立てます（「有効だがインストールされていない」）。修正方法は同じupdate_agent呼び出し、またはユーザーがそのプラグインをそこに決して望んでいなかった場合はそのままにしておくことです。
専用画面
bot_screen: trueは、ゲートウェイホスト上にBotにデスクトップを提供します：Botはそこでブラウズしてクリックし、ユーザーはHermes Desktopで監視し、ログイン、2FA、またはCAPTCHAを引き継ぎ、そして戻します — Botはユーザーがちょうどサインインしたセッションを継続します。これにより、computer_useとbrowserが付与されます。
人間による救出が必要な可能性がある実際のブラウザセッションが必要な場合にそれを要求してください：ログインの背後にあるもの、APIのないポータル、CAPTCHAに遭遇するフロー。公開ページのみを読むBotにそれを追加しないでください — webとbrowserがすでにそれをカバーしており、画面は開いている間は実際のメモリを消費します。
Linuxゲートウェイホストのみ。macOSまたはWindowsでは呼び出しが拒否されます。なぜなら、そこではBotが独自のディスプレイではなくユーザー自身のディスプレイで動作するからです。ユーザーが本当にそれを望む場合は、明示的にcomputer_useツールセットを要求します。ホストにTigerVNC/Xfceまたはcua-driverがない場合、拒否はどれが欠けているかとコマンドを示します。再試行するのではなく、それをそのまま伝えてください。
共有運用ポリシー
すべての新しいBotは、~/.hermes/shared/BOT-POLICY.mdから共有ポリシーをそのSOUL.mdにインライン化して取得します — ハウスルール（お金を使わない、シークレットを貼り付けない、確認しなかったことを報告する）。デフォルトでオンになっています。ユーザーが意図的に制約を受けないBotを要求しない限り、shared_policy: falseを渡さないでください。その場合、その旨を明確に伝えてください。
裏返し：そのファイルの編集前に作成されたBotは古いテキストを保持します。ユーザーがポリシーを編集し、どのBotが影響を受けるかを尋ねた場合、またはBotが最新かどうかを尋ねた場合、check_policies（読み取り専用）を呼び出し、staleとno_shared_policyを名前で報告してください。update_agent + refresh_shared_policy: trueで古いものを更新することを提案し、尋ねずに更新しないでください。また、BotのSOUL.mdを手動で編集して「ドリフトを修正」しないでください。これはBotが従うように求められるプロンプトテキストであり、サンドボックスではありません。ユーザーがそれを保証として扱う場合は、そのように伝えてください。
サンドボックス
terminalまたはcode_executionを与えるBotには、そのシェルがユーザーのマシンではなくコンテナ内で実行されるように、sandbox: "docker"を与えるべきです。その旨を返信で伝えてください。バックエンドが使用できないためにツールが拒否した場合は、ツールが言ったことをユーザーに伝え、サンドボックスなしでBotを提供することを提案し、再試行しないでください。
ユーザーを必要とするもの
「何か必要なものは？」、「何か私を待っているものは？」、朝または週次のチェック → check_agentsを呼び出し、waiting_on_youを先頭に表示してください：各項目は、ブロックされてそれを書き留めたBotで、何日そこに座っているかが含まれます。Botの名前と依頼を1行ずつ記載し、健全なBotのノイズの下に埋もれさせないでください。
メール
Botがblockedまたはfailedエントリを記録すると、プラグインが自動的にユーザーにメールを送信します。あなたは何も呼び出す必要はなく、agent_journalの結果にはnotifiedが含まれるため、送信された場合は「メールを送信しました」と言うことができます。これはユーザー自身のアドレスにのみ書き込むため、他の誰かにメールを送ることを決して提案しないでください。そのためのツールは設計上存在しません。ユーザーがメールが届かなかった理由を尋ねた場合、その理由はnotified.reasonにあります。通常、Hermesでメールが設定されていないことです（EMAIL_SMTP_HOST / EMAIL_ADDRESS / EMAIL_PASSWORD）。
キューの配信
「何が待っているか思い出させて」、「毎日のサマリーを送って」、「チェックするのを忘れ続けている」 → ダイジェストは自分自身を配信できます：python3 <プラグイン>/notify.py schedule "0 8 * * *"。これは--no-agent（モデルターンなし）で実行され、Hermesはそのプロファイルがすでに配信している場所に出力を配信するため、メールの設定は不要です。待っているものが何もなければ、何も送信されません。コマンドをユーザーに実行するのではなく、与えてください。これにより、自分のプロファイルにcronジョブが書き込まれます。
ヘルス
「私のボットはどうですか」または週次レビュー → check_agents。「ツールがありません」/「インストール後に何も起こりませんでした」 → check_installを実行し、ユーザーにそのnext_stepsをそのまま伝えてください。フラグを平易な言葉で報告し、修正を提案してください（update_agent / hide_agent）。尋ねずに適用しないでください。
ジャーナル
- 新しいBotはデフォルトで事実に基づく作業ジャーナルを持ちます。意味のある作業の後、
action: addでagent_journalを使用して、結果、証拠、ブロッカー、次のステップを記録してください。 - 日常的な会話はスキップしてください。認証情報、認証マテリアル、ジョブに関係のない事実、プライベートな推論、隠れた思考連鎖を決して記録しないでください。
- 「Xは何をしましたか？」/「Xのジャーナルを見せて」 →
action: readとBot名でagent_journalを呼び出してください。 - ジャーナル機能が存在する前に作成されたBot →
action: enableでagent_journalを1回呼び出してください。これにより、人物像を置き換えることなく、ジャーナルポリシーが追加されます。
別のBotへの作業の引き継ぎ
「これをNovaに渡して」、「Scoutに調査を任せて」、「Inkwellにこれを書かせて」 — または明らかに別のBotのジョブであるタスク（list_agentsで確認） → handoff_agent。これはask_agentではありません。ハンドオフは所有権を移動させます。相手のBotはタスクをエンドツーエンドで所有するように指示され、作業はユーザーが監視できるそのBotのチャットで実行され、結果はその返信からの状態読み取りとして返されます — completed ✅、needs_you ✋、blocked ⚠️、scheduled ⏳ — さらに返信内容も含まれます。
- 必要なものすべてを
contextに入れてください：あなたの調査結果、リンク、ファイルパス、制約、「完了」とはどのような状態か。相手のBotはこのチャットを見ることができません。キーやパスワードは絶対に入れないでください。
…
[翻訳のために切り詰められました]