Hermes Tweet

Hermes Tweet adiciona um conjunto de ferramentas X/Twitter ao Hermes Agent. É útil para escuta social, pesquisa de contas, monitoramento de lançamentos, triagem de suporte, auditoria de sorteios e fluxos de trabalho controlados onde operações privadas ou que alteram o estado permanecem explícitas.

Quando Usar Esta Skill

Use esta skill quando o usuário quiser:

• Instalar o Hermes Tweet em um ambiente de execução do Hermes Agent
• Descobrir rotas de leitura e ação X/Twitter disponíveis
• Ler dados de conta X/Twitter, tweet, tendência, monitoramento ou pesquisa
• Resumir sinais públicos antes de redigir respostas ou campanhas
• Manter operações privadas e que alteram o estado protegidas por intenção explícita do operador

Configuração

Instale e ative o plugin através do Hermes:

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

O Hermes escaneia plugins durante a instalação e atualizações. Revise cada aviso. Um veredito perigoso bloqueia a instalação ou desabilita uma atualização.

Defina a chave de API no host de execução do Hermes:

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

Mantenha HERMES_TWEET_ENABLE_ACTIONS como false para sessões de apenas leitura. Defina-o como true apenas para uma leitura privada aprovada, escrita, monitoramento, webhook, extração, sorteio ou operação de mídia.

Entradas

Peça por estas entradas antes de selecionar rotas:

• Objetivo: pesquisa, monitoramento, triagem de suporte, auditoria de sorteio ou preparação de ação
• Alvo: identificador da conta, URL do tweet, palavra-chave, lista, monitoramento ou tendência
• Janela de tempo e necessidades de atualização
• Se alguma operação privada ou que altera o estado está em escopo
• Confirmação de que o ambiente de execução do Hermes tem XQUIK_API_KEY

Fluxo de Trabalho

1. Pesquise o catálogo de endpoints incluído com tweet_explore para encontrar rotas correspondentes.
2. Leia dados públicos do X/Twitter através de tweet_read após selecionar uma rota do catálogo.
3. Use tweet_action para rotas privadas ou que alteram o estado apenas após aprovação explícita.
4. Mantenha as chaves de API em variáveis de ambiente ou no arquivo de ambiente do Hermes.
5. Não cole credenciais em prompts, issues, comentários de PR ou entradas de ferramentas.
6. Carregue padrões de fluxo de trabalho quando o usuário pedir um fluxo de trabalho de campanha, monitoramento, suporte ou sorteio em vez de uma única leitura.

Modelo de Ferramenta

Formato de Saída

Retorne uma saída operacional concisa:

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

Exemplos de Uso

Pesquise uma conta antes de redigir uma resposta:

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

Monitore uma palavra-chave de lançamento:

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

Prepare uma postagem protegida:

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

Capture notas de rota estruturadas:

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

Solução de Problemas

• Se apenas tweet_explore aparecer, configure XQUIK_API_KEY no host de execução do Hermes e recarregue ou reinicie a sessão ativa do Hermes.
• Se as rotas de ação estiverem indisponíveis, mantenha as leituras públicas separadas. Defina HERMES_TWEET_ENABLE_ACTIONS=true apenas para uma operação privada ou que altera o estado aprovada.
• Se uma rota não corresponder, use tweet_explore novamente e escolha um caminho listado no catálogo em vez de adivinhar endpoints.

Melhores Práticas

• Trate o Hermes Tweet como a camada X/Twitter nativa do Hermes, não como um wrapper genérico de API.
• Mantenha a pesquisa como apenas leitura por padrão. Exija aprovação antes de criar ou alterar monitores.
• Use revisão do operador no Desktop ou gateway antes de chamadas privadas ou que alteram o estado.
• Valide o caminho exato do catálogo antes de chamar tweet_read ou tweet_action.
• Reinicie sessões do gateway, cron ou do Hermes de longa duração após alterações de ambiente.

Veja Também

…