Hermes Tweet
Hermes TweetはHermes AgentにX/Twitter用ツールセットを追加します。ソーシャルリスニング、アカウント調査、ローンチ監視、サポートトリアージ、ギブアウェイ監査、そしてプライベートまたは状態変更操作を明示的に制御するワークフローに役立ちます。
このスキルを使用するタイミング
以下のような場合にこのスキルを使用します。
- Hermes AgentランタイムにHermes Tweetをインストールする
- 利用可能な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に保ちます。承認されたプライベート読み取り、書き込み、モニター、ウェブフック、抽出、ドロー、メディア操作の場合にのみtrueに設定します。
インプット
ルートを選択する前に以下の入力を確認します。
- 目的：リサーチ、監視、サポートトリアージ、ギブアウェイ監査、またはアクション準備
- ターゲット：アカウントハンドル、ツイートURL、キーワード、リスト、モニター、またはトレンド
- 時間枠と鮮度の要件
- プライベートまたは状態変更操作の有無
- Hermesランタイムに
XQUIK_API_KEYが設定されていることの確認
ワークフロー
tweet_exploreでバンドルされたエンドポイントカタログを検索し、該当するルートを見つけます。- カタログルートを選択した後、
tweet_readで公開X/Twitterデータを読み取ります。 - プライベートまたは状態変更ルートには、明示的な承認を得た後にのみ
tweet_actionを使用します。 - APIキーは環境変数またはHermesランタイムのenvファイルに保存します。
- 認証情報をプロンプト、Issue、PRコメント、またはツール入力に貼り付けないでください。
- ユーザーが単発の読み取りではなく、キャンペーン、モニター、サポート、またはギブアウェイのワークフローを依頼した場合は、ワークフローパターンを読み込みます。
ツールモデル
| ツール | 目的 |
|---|---|
tweet_explore | APIキーを使わずにバンドルされたエンドポイントカタログを検索します。 |
tweet_read | XQUIK_API_KEYが設定されている場合に、カタログにリストされた公開読み取り専用エンドポイントを呼び出します。 |
tweet_action | アクションゲートが有効な場合のみ、プライベート読み取り、書き込み、モニター、ウェブフック、抽出、ドロー、メディア操作を呼び出します。 |
出力形式
簡潔な運用出力を返します。
サマリー:
- 何をチェックしたかとその理由
読み取りルート:
- カタログパス、入力、結果の要約
アクションプラン:
- 提案されたプライベートまたは状態変更操作（それぞれ明示的な承認待ち）
次のチェック:
- 有用な場合のフォローアップルートまたは監視頻度
使用例
返信を作成する前にアカウントを調査する場合：
Hermes Tweetを使用して、返信を作成する前に@exampleの最近の公開コンテキストを調査してください。アクションは無効にしたままにしてください。
ローンチキーワードを監視する場合：
今日の「Example Launch」に関するX/Twitterでの言及を追跡してください。テーマと注目アカウントを要約してください。投稿はしないでください。
ガード付きの投稿を準備する場合：
ローンチツイートをドラフトし、使用する正確なtweet_action呼び出しをリストしてください。アクションルートの前に承認を待ってください。
構造化ルートメモを記録する場合：
{
"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レイヤーとして扱います。
- デフォルトではリサーチを読み取り専用に保ちます。モニターの作成や変更には承認を必要とします。
- プライベートまたは状態変更の呼び出しの前に、デスクトップまたはゲートウェイオペレーターによるレビューを使用します。
tweet_readまたはtweet_actionを呼び出す前に、正確なカタログパスを検証します。- 環境変更後は、ゲートウェイ、cron、または長時間稼働するHermesセッションを再起動します。
関連情報
ソーシャルパブリッシングプラグインは、Hermes Tweetを補完し、幅広いマルチプラットフォームパブリッシングを提供します。Hermes TweetはHermes AgentのX/Twitterツールセットと、その読み取り優先・承認ゲート方式の運用モデルに特化しています。
ルートの境界が不明確な場合は、エンドポイントと承認契約を参照してください。公式ガイドはhttps://github.com/Xquik-dev/hermes-tweet#readmeをご覧ください。