Hermes Tweet 工作流模式实战在 Hermes Agent 中构建 X/Twitter 只读优先、审批门控的研究与运营流程【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents本文是 Hermes Tweet 插件工作流模式Workflow Patterns的完整实战指南聚焦于「请求范围超出单一路由查询」时的四种标准工作流社交监听Social Listening、支持分流Support Triage、抽奖审计Giveaway Audit与受控发布Controlled Publishing。围绕 workflows.md 展开并结合 SKILL.md 与 endpoint-contract.md 补充安装、工具模型、审批清单与运行时校验细节。读完本文你将能在一个 Hermes Agent 会话中正确组合tweet_explore/tweet_read/tweet_action三类工具安全地完成监听、分流、审计与发布前准备等复合型 X/Twitter 任务。一、工作流模式的定位何时使用、为何需要Hermes Tweet 为 Hermes Agent 提供一套面向 X/Twitter 的工具集用于社交监听、账号研究、发布信号监控、支持分流、抽奖审计等场景。它的工具模型刻意做成「三层分离」以保证只读优先与审批门控approval-gated的执行模型工具用途是否需要XQUIK_API_KEY是否访问网络是否受动作门控是否需要用户审批tweet_explore在本地捆绑的端点目录catalog中搜索可用路由不使用 API key否否否否tweet_read调用目录中列出的公开只读端点是是否公开只读路由无需tweet_action私有读取、写入、监控、Webhook、抽取任务、抽奖与媒体操作是是是是针对具体操作工具矩阵见 endpoint-contract.md当用户需求只是「查某条推文」「看某个账号」这类单次查询时直接走「tweet_explore找路由 →tweet_read读取」即可而当请求涉及监听、营销活动、客服分流、抽奖审计或受控发布——也就是比单一路由查询更宽泛的任务时就应该加载本工作流文档作为执行骨架。/tweet_explore 搜索目录路由 → /tweet_read 公开只读 → 审批通过后/tweet_action 门控操作这套分层的关键约束来自 SKILL.mdtweet_explore只读取捆绑的端点目录不消耗 API key适合任何阶段的路由发现tweet_read仅在设置了XQUIK_API_KEY时可用且只接受目录中列出的公开只读路由tweet_action仅在动作门控启用时可用处理写入、私有读取、监控、Webhook、抽取、抽奖与媒体操作。二、前置条件安装、环境变量与动作门控工作流模式的正确执行依赖正确的运行时配置。安装 Hermes Tweet 并启用插件hermes plugins install Xquik-dev/hermes-tweet --enableHermes 会在安装与更新期间扫描插件并逐条提示告警若扫描判定存在危险dangerous verdict会直接阻止安装或禁用更新因此安装时需认真阅读每条警告。在 Hermes 运行时主机上设置环境变量export XQUIK_API_KEYyour-key export HERMES_TWEET_ENABLE_ACTIONSfalse两个变量的语义来自 SKILL.mdXQUIK_API_KEY读取与动作工具都需要它。若缺失会话里只会出现tweet_explore。HERMES_TWEET_ENABLE_ACTIONS动作门控开关。只读优先的会话应始终保持false只有在经过审批的私有读取、写入、监控、Webhook、抽取、抽奖或媒体操作之前才临时置为true且必须是有意为之的配置而不是顺手的默认值。修改环境变量后需要重启或重新加载有效的 Hermes 会话如果是 gateway 场景则运行hermes gateway restart后开启新的 gateway 会话见 endpoint-contract.md 的 Runtime Checks 一节。三、社交监听Social Listening适用场景监听某关键词、话题趋势、账号动态聚合信号用于启动监控或营销判断。执行顺序路由发现用tweet_explore搜索search、trend、radar、monitor四类路由——覆盖搜索、趋势、雷达扫描与监控端点先确认目录里到底有哪些可用路径而不是凭记忆猜测端点只读读取对选中的目录路由调用tweet_read执行公开只读查询创建/变更监控前先审批如果监听结论需要沉淀为长期 monitor任何「新建监控」或「修改既有监控」的tweet_action调用都必须在执行前征得用户批准结果聚合按主题theme、账号account、链接link与时效recency四个维度对结果分组形成结构化信号信号补全当聚合结果不足以支撑结论signal 不完整时主动推荐一个后续的读取路由把「信号缺口」转化为「下一步读取动作」。这一步推荐配合 SKILL.md 的 Output Format 输出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监听启动信号的典型提示词示例Track X/Twitter mentions for Example Launch today. Summarize themes and notable accounts. Do not post.四、支持分流Support Triage适用场景处理 提及、私信或与某账号相关的客诉先读清上下文再谨慎回复。执行顺序读上下文读取提及mentions、账号上下文account context与相关推文线程tweet threads去敏总结在向用户汇报问题摘要时不得暴露任何凭证或私有运行时数据credentials / private runtime data只呈现公开信号与可验证的摘要草稿与动作分离回复草稿必须与动作调用分开撰写——先给草稿再谈执行显式审批任何私有读取、回复reply、私信DM、关注follow或 Webhook 操作都必须先获得用户的明确批准才进入tweet_action。这一步的纪律本质上是「先读后写、先批准后执行」分流动作涉及的tweet_action路由回复、DM、关注、Webhook都属于有外部副作用的操作不能因为「用户问了客服场景」就自动放行。结构化记录路由笔记时可参考 SKILL.md 给出的 JSON 形态{ objective: support-triage, route: /api/v1/x/search, action_gate: disabled, approval_required: true }五、抽奖审计Giveaway Audit适用场景核对某条抽奖推文的参与情况、转发者、粉丝构成与公开名单判断抽奖的合规性与可执行性。执行顺序公开取证读取原始推文original tweet、回复replies、转发reposts、粉丝followers与公开列表public lists——这些全部落在公开只读范围内保留证据链对每次读取记录「路由路径 结果摘要」作为审计证据链evidence trail确保审计过程可复现、可回溯审批门控私有读取、抽取作业extraction jobs或抽奖开奖giveaway draws必须先征求批准——开奖属于有状态操作绝不自动执行候选方案在公开只读证据收集完整后向用户呈现候选的下一步动作candidate next steps把决策权交还给用户。审计工作流的证据链设计与本文档后续的审批清单见第七节是一体两面的审计要求「先取证」而取证之后任何有副作用的动作都必须「先批准」。六、受控发布Controlled Publishing适用场景为一条推文、媒体、回复、定时任务或账号切换做准备把「发布」变成「发布前的受控流程」。执行顺序确认门控先确认本会话HERMES_TWEET_ENABLE_ACTIONStrue是有意配置的而不是历史遗留或误开如果该变量不是true动作路由根本不可用发布流程应停留在草稿阶段草稿与路由绑定撰写内容草稿并精确锁定将要调用的tweet_action路由例如发帖、回复、定时、媒体上传、账号切换各有不同路由必须逐一确认目录路径执行前展示输入在执行前完整展示媒体media、回复reply、调度scheduling或账号变更account-change的输入让用户看到「将要发生什么」等待批准后单次调用获得批准后只调用被批准的那一个路由——批准一次操作不代表授权重试、关联操作或未来的定时运行。受控发布的提示词示例来自 SKILL.mdDraft a launch tweet and list the exact tweet_action call you would use. Wait for approval before any action route.七、贯穿四类工作流的审批契约上述四类工作流表面各异底层共享同一份审批契约endpoint-contract.md。在调用任何tweet_action之前必须陈述并确认五项内容目录中列出的端点与 HTTP 方法catalog-listed endpoint and method目标账号或工作流target account or workflow不含凭证的完整负载complete payload without credentials预期副作用及理由expected side effects and reason用户对该操作显式的批准users explicit approval。两条硬性边界必须牢记批准不可泛化一次操作的批准不授权重试、关联操作或未来的定时运行失败即停遇到策略、认证、校验或账号状态失败时立即停止不要自行「修复后重试」。该契约适用于 CLI、Desktop、dashboard、gateway、定时调度与委托式delegated的所有 Hermes Agent 会话不是某一种运行模式的局部约束。八、运行时校验与排障工作流跑不动时先用两条命令核对工具可见性endpoint-contract.mdhermes plugins list hermes tools list期望状态tweet_explore在没有XQUIK_API_KEY时依然可见tweet_read只有设置了 key 才出现tweet_action在未刻意配置HERMES_TWEET_ENABLE_ACTIONStrue时保持不可用。常见故障与处理SKILL.md Troubleshooting只剩tweet_explore说明XQUIK_API_KEY未配置。在 Hermes 运行时主机上配置 key然后重新加载或重启当前 Hermes 会话gateway、cron 或长驻会话在环境变量变更后必须重启动作路由不可用这是预期行为保持公开读取与动作分离。仅在确有审批通过的私有或状态变更操作时才设置HERMES_TWEET_ENABLE_ACTIONStrue路由不匹配不要猜端点重新用tweet_explore搜索目录并选择目录中列出的路径。环境变量一律放在环境变量或 Hermes 运行时 env 文件中严禁把凭证粘贴进 prompt、issue、PR 评论或工具输入SKILL.md Workflow 第 4、5 条。九、最佳实践与生态定位结合四类工作流Hermes Tweet 的完整操作纪律可以归纳为SKILL.md Best Practices把它当作 Hermes 原生的 X/Twitter 层而不是一个通用 API 包装器——路由发现、读取、动作三层语义都由 Hermes 工具承载只读为默认研究场景默认只读创建或修改 monitor 前必须先审批人审门槛私有或状态变更调用前使用 Desktop 或 gateway 的 operator review 进行人工复核精确路由调用tweet_read或tweet_action前先验证确切的目录路径拒绝猜测端点环境变更即重启gateway、cron、长驻会话在环境变量变化后必须重启。生态定位上social-publishing 插件 面向 13 个平台的跨平台发布与调度Hermes Tweet 则聚焦 Hermes Agent 内的 X/Twitter 工具集及其「只读优先 审批门控」运行模型——两者互补而非重叠前者管广度多平台后者管深度与门控单平台、多工作流。十、快速决策表用户请求形态采用工作流门控要点监听关键词/趋势/账号或需要建 monitorSocial Listening创建/修改 monitor 前审批处理提及、客诉、账号上下文Support Triage私有读取/回复/DM/关注/Webhook 前审批核对转发、粉丝、公开名单的抽奖Giveaway Audit私有读取/抽取/开奖前审批保留证据链准备发帖、回复、媒体、定时、账号切换Controlled Publishing确认HERMES_TWEET_ENABLE_ACTIONStrue后按路由审批单次公开查询不需要工作流直接 explore read无需审批把这张表连同 workflows.md、endpoint-contract.md 与 SKILL.md 一起放入技能加载路径即可在任何 Hermes 会话中把 X/Twitter 复合任务稳定地约束在「只读优先、审批门控、证据可溯」的轨道上。【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Hermes Tweet 工作流模式实战：在 Hermes Agent 中构建 X/Twitter 只读优先、审批门控的研究与运营流程
Hermes Tweet 工作流模式实战在 Hermes Agent 中构建 X/Twitter 只读优先、审批门控的研究与运营流程【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents本文是 Hermes Tweet 插件工作流模式Workflow Patterns的完整实战指南聚焦于「请求范围超出单一路由查询」时的四种标准工作流社交监听Social Listening、支持分流Support Triage、抽奖审计Giveaway Audit与受控发布Controlled Publishing。围绕 workflows.md 展开并结合 SKILL.md 与 endpoint-contract.md 补充安装、工具模型、审批清单与运行时校验细节。读完本文你将能在一个 Hermes Agent 会话中正确组合tweet_explore/tweet_read/tweet_action三类工具安全地完成监听、分流、审计与发布前准备等复合型 X/Twitter 任务。一、工作流模式的定位何时使用、为何需要Hermes Tweet 为 Hermes Agent 提供一套面向 X/Twitter 的工具集用于社交监听、账号研究、发布信号监控、支持分流、抽奖审计等场景。它的工具模型刻意做成「三层分离」以保证只读优先与审批门控approval-gated的执行模型工具用途是否需要XQUIK_API_KEY是否访问网络是否受动作门控是否需要用户审批tweet_explore在本地捆绑的端点目录catalog中搜索可用路由不使用 API key否否否否tweet_read调用目录中列出的公开只读端点是是否公开只读路由无需tweet_action私有读取、写入、监控、Webhook、抽取任务、抽奖与媒体操作是是是是针对具体操作工具矩阵见 endpoint-contract.md当用户需求只是「查某条推文」「看某个账号」这类单次查询时直接走「tweet_explore找路由 →tweet_read读取」即可而当请求涉及监听、营销活动、客服分流、抽奖审计或受控发布——也就是比单一路由查询更宽泛的任务时就应该加载本工作流文档作为执行骨架。/tweet_explore 搜索目录路由 → /tweet_read 公开只读 → 审批通过后/tweet_action 门控操作这套分层的关键约束来自 SKILL.mdtweet_explore只读取捆绑的端点目录不消耗 API key适合任何阶段的路由发现tweet_read仅在设置了XQUIK_API_KEY时可用且只接受目录中列出的公开只读路由tweet_action仅在动作门控启用时可用处理写入、私有读取、监控、Webhook、抽取、抽奖与媒体操作。二、前置条件安装、环境变量与动作门控工作流模式的正确执行依赖正确的运行时配置。安装 Hermes Tweet 并启用插件hermes plugins install Xquik-dev/hermes-tweet --enableHermes 会在安装与更新期间扫描插件并逐条提示告警若扫描判定存在危险dangerous verdict会直接阻止安装或禁用更新因此安装时需认真阅读每条警告。在 Hermes 运行时主机上设置环境变量export XQUIK_API_KEYyour-key export HERMES_TWEET_ENABLE_ACTIONSfalse两个变量的语义来自 SKILL.mdXQUIK_API_KEY读取与动作工具都需要它。若缺失会话里只会出现tweet_explore。HERMES_TWEET_ENABLE_ACTIONS动作门控开关。只读优先的会话应始终保持false只有在经过审批的私有读取、写入、监控、Webhook、抽取、抽奖或媒体操作之前才临时置为true且必须是有意为之的配置而不是顺手的默认值。修改环境变量后需要重启或重新加载有效的 Hermes 会话如果是 gateway 场景则运行hermes gateway restart后开启新的 gateway 会话见 endpoint-contract.md 的 Runtime Checks 一节。三、社交监听Social Listening适用场景监听某关键词、话题趋势、账号动态聚合信号用于启动监控或营销判断。执行顺序路由发现用tweet_explore搜索search、trend、radar、monitor四类路由——覆盖搜索、趋势、雷达扫描与监控端点先确认目录里到底有哪些可用路径而不是凭记忆猜测端点只读读取对选中的目录路由调用tweet_read执行公开只读查询创建/变更监控前先审批如果监听结论需要沉淀为长期 monitor任何「新建监控」或「修改既有监控」的tweet_action调用都必须在执行前征得用户批准结果聚合按主题theme、账号account、链接link与时效recency四个维度对结果分组形成结构化信号信号补全当聚合结果不足以支撑结论signal 不完整时主动推荐一个后续的读取路由把「信号缺口」转化为「下一步读取动作」。这一步推荐配合 SKILL.md 的 Output Format 输出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监听启动信号的典型提示词示例Track X/Twitter mentions for Example Launch today. Summarize themes and notable accounts. Do not post.四、支持分流Support Triage适用场景处理 提及、私信或与某账号相关的客诉先读清上下文再谨慎回复。执行顺序读上下文读取提及mentions、账号上下文account context与相关推文线程tweet threads去敏总结在向用户汇报问题摘要时不得暴露任何凭证或私有运行时数据credentials / private runtime data只呈现公开信号与可验证的摘要草稿与动作分离回复草稿必须与动作调用分开撰写——先给草稿再谈执行显式审批任何私有读取、回复reply、私信DM、关注follow或 Webhook 操作都必须先获得用户的明确批准才进入tweet_action。这一步的纪律本质上是「先读后写、先批准后执行」分流动作涉及的tweet_action路由回复、DM、关注、Webhook都属于有外部副作用的操作不能因为「用户问了客服场景」就自动放行。结构化记录路由笔记时可参考 SKILL.md 给出的 JSON 形态{ objective: support-triage, route: /api/v1/x/search, action_gate: disabled, approval_required: true }五、抽奖审计Giveaway Audit适用场景核对某条抽奖推文的参与情况、转发者、粉丝构成与公开名单判断抽奖的合规性与可执行性。执行顺序公开取证读取原始推文original tweet、回复replies、转发reposts、粉丝followers与公开列表public lists——这些全部落在公开只读范围内保留证据链对每次读取记录「路由路径 结果摘要」作为审计证据链evidence trail确保审计过程可复现、可回溯审批门控私有读取、抽取作业extraction jobs或抽奖开奖giveaway draws必须先征求批准——开奖属于有状态操作绝不自动执行候选方案在公开只读证据收集完整后向用户呈现候选的下一步动作candidate next steps把决策权交还给用户。审计工作流的证据链设计与本文档后续的审批清单见第七节是一体两面的审计要求「先取证」而取证之后任何有副作用的动作都必须「先批准」。六、受控发布Controlled Publishing适用场景为一条推文、媒体、回复、定时任务或账号切换做准备把「发布」变成「发布前的受控流程」。执行顺序确认门控先确认本会话HERMES_TWEET_ENABLE_ACTIONStrue是有意配置的而不是历史遗留或误开如果该变量不是true动作路由根本不可用发布流程应停留在草稿阶段草稿与路由绑定撰写内容草稿并精确锁定将要调用的tweet_action路由例如发帖、回复、定时、媒体上传、账号切换各有不同路由必须逐一确认目录路径执行前展示输入在执行前完整展示媒体media、回复reply、调度scheduling或账号变更account-change的输入让用户看到「将要发生什么」等待批准后单次调用获得批准后只调用被批准的那一个路由——批准一次操作不代表授权重试、关联操作或未来的定时运行。受控发布的提示词示例来自 SKILL.mdDraft a launch tweet and list the exact tweet_action call you would use. Wait for approval before any action route.七、贯穿四类工作流的审批契约上述四类工作流表面各异底层共享同一份审批契约endpoint-contract.md。在调用任何tweet_action之前必须陈述并确认五项内容目录中列出的端点与 HTTP 方法catalog-listed endpoint and method目标账号或工作流target account or workflow不含凭证的完整负载complete payload without credentials预期副作用及理由expected side effects and reason用户对该操作显式的批准users explicit approval。两条硬性边界必须牢记批准不可泛化一次操作的批准不授权重试、关联操作或未来的定时运行失败即停遇到策略、认证、校验或账号状态失败时立即停止不要自行「修复后重试」。该契约适用于 CLI、Desktop、dashboard、gateway、定时调度与委托式delegated的所有 Hermes Agent 会话不是某一种运行模式的局部约束。八、运行时校验与排障工作流跑不动时先用两条命令核对工具可见性endpoint-contract.mdhermes plugins list hermes tools list期望状态tweet_explore在没有XQUIK_API_KEY时依然可见tweet_read只有设置了 key 才出现tweet_action在未刻意配置HERMES_TWEET_ENABLE_ACTIONStrue时保持不可用。常见故障与处理SKILL.md Troubleshooting只剩tweet_explore说明XQUIK_API_KEY未配置。在 Hermes 运行时主机上配置 key然后重新加载或重启当前 Hermes 会话gateway、cron 或长驻会话在环境变量变更后必须重启动作路由不可用这是预期行为保持公开读取与动作分离。仅在确有审批通过的私有或状态变更操作时才设置HERMES_TWEET_ENABLE_ACTIONStrue路由不匹配不要猜端点重新用tweet_explore搜索目录并选择目录中列出的路径。环境变量一律放在环境变量或 Hermes 运行时 env 文件中严禁把凭证粘贴进 prompt、issue、PR 评论或工具输入SKILL.md Workflow 第 4、5 条。九、最佳实践与生态定位结合四类工作流Hermes Tweet 的完整操作纪律可以归纳为SKILL.md Best Practices把它当作 Hermes 原生的 X/Twitter 层而不是一个通用 API 包装器——路由发现、读取、动作三层语义都由 Hermes 工具承载只读为默认研究场景默认只读创建或修改 monitor 前必须先审批人审门槛私有或状态变更调用前使用 Desktop 或 gateway 的 operator review 进行人工复核精确路由调用tweet_read或tweet_action前先验证确切的目录路径拒绝猜测端点环境变更即重启gateway、cron、长驻会话在环境变量变化后必须重启。生态定位上social-publishing 插件 面向 13 个平台的跨平台发布与调度Hermes Tweet 则聚焦 Hermes Agent 内的 X/Twitter 工具集及其「只读优先 审批门控」运行模型——两者互补而非重叠前者管广度多平台后者管深度与门控单平台、多工作流。十、快速决策表用户请求形态采用工作流门控要点监听关键词/趋势/账号或需要建 monitorSocial Listening创建/修改 monitor 前审批处理提及、客诉、账号上下文Support Triage私有读取/回复/DM/关注/Webhook 前审批核对转发、粉丝、公开名单的抽奖Giveaway Audit私有读取/抽取/开奖前审批保留证据链准备发帖、回复、媒体、定时、账号切换Controlled Publishing确认HERMES_TWEET_ENABLE_ACTIONStrue后按路由审批单次公开查询不需要工作流直接 explore read无需审批把这张表连同 workflows.md、endpoint-contract.md 与 SKILL.md 一起放入技能加载路径即可在任何 Hermes 会话中把 X/Twitter 复合任务稳定地约束在「只读优先、审批门控、证据可溯」的轨道上。【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
