hermes-tweet

Hermes Tweet

Hermes Tweet は、Hermes Agent に X/Twitter ツールセットを追加します。ソーシャルリスニング、アカウント調査、ローンチの監視、サポートのトリアージ、ギブアウェイの監査、そしてプライベートな操作や状態を変更する操作を明示的に保つ制御されたワークフローに役立ちます。

このスキルを使用する場面

ユーザーが次のことを望む場合にこのスキルを使用します:

• Hermes Tweet を Hermes Agent ランタイムにインストールする
• 利用可能な X/Twitter の読み取りおよびアクションのルートを確認する
• X/Twitter のアカウント、ツイート、トレンド、モニター、検索データを読み取る
• 返信やキャンペーンを作成する前に公開シグナルを要約する
• プライベートな操作および状態を変更する操作を、明示的なオペレーターの意思の背後に制限しておく

セットアップ

Hermes を通じてプラグインをインストールして有効化します:

hermes plugins install Xquik-dev/hermes-tweet --enable

Hermes はインストール時および更新時にプラグインをスキャンします。各警告を確認してください。 危険と判定された場合はインストールがブロックされるか、更新が無効化されます。

Hermes ランタイムホストに API キーを設定します:

export XQUIK_API_KEY="<your-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"

読み取り優先のセッションでは HERMES_TWEET_ENABLE_ACTIONS を false のままにしてください。承認されたプライベートな読み取り、書き込み、モニター、Webhook、抽出、抽選、メディア操作に限り true に設定します。

入力

ルートを選択する前に、次の入力を確認してください:

• 目的: 調査、監視、サポートのトリアージ、ギブアウェイの監査、またはアクションの準備
• 対象: アカウントハンドル、ツイート URL、キーワード、リスト、モニター、またはトレンド
• 時間枠と鮮度の要件
• プライベートな操作または状態を変更する操作が対象範囲に含まれるかどうか
• Hermes ランタイムに XQUIK_API_KEY があることの確認

ワークフロー

1. tweet_explore で同梱のエンドポイントカタログを検索し、一致するルートを見つけます。
2. カタログのルートを選択した後、tweet_read を通じて公開 X/Twitter データを読み取ります。
3. プライベートなルートまたは状態を変更するルートには、明示的な承認を得た後に限り tweet_action を使用します。
4. API キーは環境変数または Hermes ランタイムの env ファイルに保管します。
5. 認証情報をプロンプト、イシュー、PR コメント、ツール入力に貼り付けないでください。
6. ユーザーが単一の読み取りではなく、キャンペーン、モニター、サポート、またはギブアウェイのワークフローを求めた場合は、ワークフローパターンを読み込みます。

ツールモデル

ツール	目的
tweet_explore	API キーを使用せずに、同梱のエンドポイントカタログを検索します。
tweet_read	XQUIK_API_KEY が設定されている場合に、カタログに記載された公開読み取り専用エンドポイントを呼び出します。
tweet_action	アクションのゲートが有効な場合に限り、プライベートな読み取り、書き込み、モニター、Webhook、抽出、抽選、メディア操作を呼び出します。

出力形式

簡潔な運用出力を返します:

Summary:
- What was checked and why

Read routes:
- Catalog path, input, and result summary

Action plan:
- Proposed private or state-changing operations, each awaiting explicit approval

Next check:
- Follow-up route or monitoring cadence when useful

使用例

返信を作成する前にアカウントを調査する:

Use Hermes Tweet to inspect recent public context for @example before drafting a reply.
Keep actions disabled.

ローンチのキーワードを監視する:

Track X/Twitter mentions for "Example Launch" today.
Summarize themes and notable accounts. Do not post.

ガードされた投稿を準備する:

Draft a launch tweet and list the exact tweet_action call you would use.
Wait for approval before any action route.

構造化されたルートノートを記録する:

{
  "objective": "support-triage",
  "route": "/api/v1/x/search",
  "action_gate": "disabled",
  "approval_required": true
}

トラブルシューティング

• tweet_explore しか表示されない場合は、Hermes ランタイムホストに XQUIK_API_KEY を設定し、アクティブな Hermes セッションを再読み込みまたは再起動してください。
• アクションルートが利用できない場合は、公開読み取りを分離しておいてください。承認されたプライベートな操作または状態を変更する操作に限り、HERMES_TWEET_ENABLE_ACTIONS=true を設定します。
• ルートが一致しない場合は、再度 tweet_explore を使用し、エンドポイントを推測するのではなく、カタログに記載されたパスを選択してください。

ベストプラクティス

• Hermes Tweet は、汎用 API ラッパーではなく、Hermes ネイティブの X/Twitter レイヤーとして扱ってください。
• 調査はデフォルトで読み取り専用に保ってください。モニターを作成または変更する前に承認を必須とします。
• プライベートな呼び出しまたは状態を変更する呼び出しの前に、Desktop またはゲートウェイのオペレーターレビューを使用してください。
• tweet_read または tweet_action を呼び出す前に、正確なカタログパスを検証してください。
• env の変更後は、ゲートウェイ、cron、または長時間実行中の Hermes セッションを再起動してください。

関連情報

ソーシャルパブリッシングプラグインは、幅広いマルチプラットフォームへの公開において Hermes Tweet を補完します。Hermes Tweet は、Hermes Agent の X/Twitter ツールセットとその読み取り優先、承認ゲート付きの運用モデルに焦点を当てています。

ルートの境界が不明確な場合は、エンドポイントと承認の契約を参照してください。公式ガイドは https://github.com/Xquik-dev/hermes-tweet#readme を参照してください。