hermes

Hermes

最初に使用する

Hermes Agent のセルフホスティングと日常的な運用に使用します。インストール、セットアップ、モデル／プロバイダーの選択、ゲートウェイプラットフォーム、Slack チャネルのセットアップ、コマンドの確認、更新、プラグイン、ツール、スキル、メモリ、プロファイル、MCP、cron、Kanban、delegate_task サブエージェント、ログ、ダッシュボード、チュートリアル、長時間実行する tmux セッションが対象です。

古い記憶に基づくコマンドは使用しないでください。Hermes は頻繁に変更されます。Hermes に関する各タスクの開始時に、このスキルのディレクトリを基準に scripts/hermes_check.py の場所を特定して実行してください。

python3 <skill-dir>/scripts/hermes_check.py --json

コマンドの動作を確認する必要がある場合は、生成済みのローカルコマンドスナップショットも更新してください。

python3 <skill-dir>/scripts/hermes_check.py --write-help <skill-dir>/references/command-map.generated.md

設定を変更する前に、更新が利用可能かどうかを報告してください。ユーザーがすでに更新を依頼している場合を除き、明示的な承認なしに hermes update を実行しないでください。

判断フロー

1. scripts/hermes_check.py でローカルの状態を確認します。
2. 実行可能なコマンドの信頼できる情報源として、hermes --help と hermes <command> --help を使用します。
3. 必要なリファレンスファイルのみを読み込みます。
   • インストール、バージョン管理、更新、設定の健全性、バックアップ、安全な更新ポリシーには、references/setup-and-update.md を使用します。
   • 初回セットアップ、セルフホスティングの方法、ガイド付きの使用フロー、ユーザー向けチュートリアルには、references/getting-started-tutorials.md を使用します。
   • コマンドのカテゴリと一般的な CLI パターンには、references/command-catalog.md を使用します。
   • 公式ドキュメント、リリース、リファレンス、トラブルシューティングへのリンクには、references/official-links.md を使用します。
   • Slack アプリ、チャネル、Socket Mode、マニフェスト、ゲートウェイ、許可リストのセットアップには、references/slack-gateway.md を使用します。
   • tmux セッション、単発実行、プロファイル、cron、Webhook、メモリ、スキル、自律性のガードレールには、references/operations-runbook.md を使用します。
   • 永続的なタスクボード、プロファイルワーカー、依存関係、分離されたワークスペース、ディスパッチ、タスク通知には、references/kanban-operations.md を使用します。
   • delegate_task、サブエージェントへの委任、委任、Kanban、tmux、cron、バックグラウンドのターミナル作業の選択には、references/delegation-vs-kanban.md を使用します。
   • セッション内の /... コマンド、ゲートウェイのスラッシュコマンド、CLI コマンドを優先するタイミングには、references/slash-commands.md を使用します。
   • キーのパス、設定セクション、プロバイダー、ツールセット、承認モード、編集、プライバシーには、references/providers-tools-security.md を使用します。
   • ユーザー／運用担当者によるプラグインのインストール、ツールの有効化、MCP 接続、安全な検証には、references/plugins-and-tools.md を使用します。
   • STT、TTS、音声モード、画像入力、メディア関連のトラブルシューティングには、references/voice-and-media.md を使用します。
   • 新しい Hermes の動作やコマンドの変更、運用上の教訓の発見後にこのスキルを更新するには、references/self-improvement.md を使用します。
   • ログ、Slack の障害、トークンの問題、古いスキル、ゲートウェイの問題、コミュニティで知られている落とし穴には、references/troubleshooting.md を使用します。
   • 正確なローカルのヘルプ出力が必要な場合にのみ、references/command-map.generated.md を使用します。
4. Hermes または tmux で対話的に作業する場合は、キーを送信する前に現在のペインを読み取ります。入力を送信する前に、プロンプトの内容を説明し、選択肢を提案します。
5. 検査には、決定的なコマンドとスクリプトを優先します。決定性のないガイダンスは、リファレンスドキュメントまたは Hermes との会話内に記載してください。
6. Hermes に関する各タスクの終了時に、references/self-improvement.md に記載された自己改善レビューを実行します。

よくあるリクエストの振り分け

• 「Hermes をインストールする」または「Hermes をセルフホストする」→ getting-started-tutorials.md、setup-and-update.md、続いて official-links.md。
• 「Slack チャンネルを設定する」→ slack-gateway.md、scripts/hermes_slack_check.py を実行し、続いて troubleshooting.md。
• 「Hermes が正常に動作しているか確認する」→ scripts/hermes_ops_check.py を実行し、続いて setup-and-update.md。
• 「プラグイン／ツール／MCP サーバーを有効にする」→ plugins-and-tools.md、providers-tools-security.md。
• 「Hermes の使い方を教えて」→ getting-started-tutorials.md、slash-commands.md、command-catalog.md。
• 「Kanban を使う」、「ワーカーにタスクを割り当てる」、または「プロファイルを調整する」→ kanban-operations.md、operations-runbook.md。
• 「delegate_task を使う」、「これを委任する」、「サブエージェントを起動する」、または「サブタスクを並行して実行する」→ delegation-vs-kanban.md。永続化が必要な場合、人が確認できる必要がある場合、再開可能にする必要がある場合、または名前付きプロファイルに割り当てる必要がある場合は、代わりに Kanban を使用します。

現在の CLI の基準

Hermes Agent v0.12.0 時点では、次を優先してください。

hermes
hermes chat -q "single query"
hermes -z "script-friendly one-shot"
hermes setup
hermes model
hermes doctor
hermes config check
hermes update --check
hermes gateway setup
hermes gateway status
hermes slack manifest

hermes run を前提とした古いサードパーティの例は避けてください。現在の Hermes では、v0.12.0 のルートコマンドとして run は公開されていません。

安全性に関するルール

• ~/.hermes/.env、Slack トークン、OAuth トークン、~/.hermes/auth.json は秘密情報として扱ってください。トークンの値全体を表示しないでください。
• Slack やその他のゲートウェイを有効にする前に、許可リストを設定または確認してください。
• 更新を判断する前に hermes update --check を使用してください。リスクの高い変更には hermes backup または更新時のバックアップフラグを使用してください。
• 自動化では、まず読み取り専用／レポート作成のワークフローから始め、検証を加えたうえで、手動実行を繰り返し成功させてから cron／webhook でスケジュールしてください。
• Hermes の動作を永続化するには、チャットよりファイルを優先してください：config.yaml、.env、SOUL.md、AGENTS.md、スキル、ランブック。