{"id":"e3b6184c-d11a-43fb-b0cd-e7d6b500e218","entityType":"agent","slug":"clawhub-liuboacean-hermes-communication-bridge","name":"Hermes Communication Bridge","canonicalUrl":"https://www.xpersona.co/agent/clawhub-liuboacean-hermes-communication-bridge","canonicalPath":"/agent/clawhub-liuboacean-hermes-communication-bridge","generatedAt":"2026-10-11T11:26:13.646Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T09:03:51.380Z","emptyReason":null},"description":"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信、队列消息、异步通信 Skill: Hermes Communication Bridge Owner: liuboacean Summary: WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信、队列消息、异步通信 Tags: AI-Agents:1.0.0, Communication:1.0.0, latest:1.2.0 Version history: v1.2.0 | 2026-04-20T11:54:44.368Z | auto - Enhanced documentation with notes distinguishing the queue bridge from the event-driven hermes-memory-bridge system, including migration advice. - Updated descr","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s1779brgcyhkdmz9tgjpwarx3h84vb82:hermes-communication-bridge","sourceUrl":"https://clawhub.ai/liuboacean/hermes-communication-bridge","homepage":"https://clawhub.ai/liuboacean/skills/hermes-communication-bridge","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/liuboacean/hermes-communication-bridge","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/liuboacean/skills/hermes-communication-bridge","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信、队列消息、异步通信 Skill: Hermes Communication Bridge Owner: liuboacean Summary: WorkBuddy 与 Herme"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:03:51.380Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:03:51.380Z","emptyReason":null},"stars":null,"forks":null,"downloads":1105,"packageName":null,"latestVersion":"1.2.0","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:03:51.305Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T09:03:51.380Z","lastCrawledAt":"2026-10-11T09:03:51.305Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T09:03:51.305Z","lastVerifiedAt":null,"highlights":[{"version":"1.2.0","createdAt":"2026-04-20T11:54:44.368Z","changelog":"- Enhanced documentation with notes distinguishing the queue bridge from the event-driven `hermes-memory-bridge` system, including migration advice. - Updated description to include more usage triggers such as queue messages and async communication. - No code or workflow changes; this update is focused on clarifying usage scenarios and recommended upgrade paths in SKILL.md.","fileCount":17,"zipByteSize":17269},{"version":"1.1.0","createdAt":"2026-04-16T13:24:01.866Z","changelog":"Bug Fix: 修复消息 ID 秒级时间戳碰撞，改用纳秒级 time_ns()。新增 Hermes 侧安装说明文档。","fileCount":16,"zipByteSize":16009},{"version":"1.0.0","createdAt":"2026-04-16T07:11:19.845Z","changelog":"Initial release — enables direct file-based message exchange between WorkBuddy and Hermes. - Adds a shared queue (`queue.json`) for bidirectional communication. - Supports multiple message types (text, task, query, etc.) and priorities. - Provides CLI for sending, receiving, and managing messages. - Tracks message history and processing status. - Includes sample workflows and detailed message format specification.","fileCount":16,"zipByteSize":15715}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1779brgcyhkdmz9tgjpwarx3h84vb82:hermes-communication-bridge","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T11:26:13.645Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-hermes-communication-bridge/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T09:03:51.380Z","emptyReason":null},"readme":"Skill: Hermes Communication Bridge\n\nOwner: liuboacean\n\nSummary: WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信、队列消息、异步通信\n\nTags: AI-Agents:1.0.0, Communication:1.0.0, latest:1.2.0\n\nVersion history:\n\nv1.2.0 | 2026-04-20T11:54:44.368Z | auto\n\n- Enhanced documentation with notes distinguishing the queue bridge from the event-driven `hermes-memory-bridge` system, including migration advice.\n- Updated description to include more usage triggers such as queue messages and async communication.\n- No code or workflow changes; this update is focused on clarifying usage scenarios and recommended upgrade paths in SKILL.md.\n\nv1.1.0 | 2026-04-16T13:24:01.866Z | user\n\nBug Fix: 修复消息 ID 秒级时间戳碰撞，改用纳秒级 time_ns()。新增 Hermes 侧安装说明文档。\n\nv1.0.0 | 2026-04-16T07:11:19.845Z | auto\n\nInitial release — enables direct file-based message exchange between WorkBuddy and Hermes.\n\n- Adds a shared queue (`queue.json`) for bidirectional communication.\n- Supports multiple message types (text, task, query, etc.) and priorities.\n- Provides CLI for sending, receiving, and managing messages.\n- Tracks message history and processing status.\n- Includes sample workflows and detailed message format specification.\n\nArchive index:\n\nArchive v1.2.0: 17 files, 17269 bytes\n\nFiles: config/default_config.json (167b), config/message_types.json (597b), scripts/auto_poller.py (829b), scripts/communication_queue.py (9697b), scripts/hermes_comm.py (1734b), scripts/process_queue.py (1256b), skill-card.md (2097b), SKILL.md (2910b), temp-repo2/config/default_config.json (167b), temp-repo2/config/message_types.json (597b), temp-repo2/README.md (1389b), temp-repo2/scripts/auto_poller.py (829b), temp-repo2/scripts/communication_queue.py (9694b), temp-repo2/scripts/hermes_comm.py (1734b), temp-repo2/scripts/process_queue.py (1256b), temp-repo2/SKILL.md (2086b), _meta.json (146b)\n\nFile v1.2.0:SKILL.md\n\n---\nname: hermes-comm\ndescription: \"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信、队列消息、异步通信\"\nversion: 1.2.0\ncategory: autonomous-ai-agents\n---\n\n# Hermes-WorkBuddy 通信桥\n\n> **v1.x 注意**：此为队列式通信桥（queue.json）。如需更强大的**事件驱动闭环命令系统**，请改用 `hermes-memory-bridge` v2.0（`~/.workbuddy/skills/hermes-memory-bridge/`）。两者可并存，各司其职。\n\n通过 `~/.hermes/shared/communication/queue.json` 共享文件队列，WorkBuddy 与 Hermes 直接双向通信。\n\n## 核心文件\n\n- 队列：`~/.hermes/shared/communication/queue.json`\n- 历史：`~/.hermes/shared/communication/history.json`\n- 技能：`~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py`\n\n## CLI 命令\n\n```bash\n# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed\n```\n\n## 消息格式\n\n```json\n{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}\n```\n\n## 类型说明\n\n- `message`：普通文本消息\n- `task`：任务请求（带元数据）\n- `query`：查询请求\n- `response`：响应\n- `status`：状态更新\n- `file`：文件传输\n- `command`：系统命令\n- `alert`：警报通知\n\n## 工作流\n\n1. **WorkBuddy 发消息**：`send workbuddy hermes \"内容\"`\n2. **Hermes 读取**：通过 cron 或 auto_poller 轮询队列，发现 pending 消息\n3. **Hermes 回复**：写 `hermes → workbuddy` 的 pending 消息\n4. **WorkBuddy 读取**：`receive workbuddy`，处理消息\n5. **标记完成**：`mark <msg_id> completed`\n\n## 版本历史\n\n### v1.1.0（2026-04-16）\n- **Bug Fix**：修复消息 ID 秒级时间戳碰撞问题，改用 `time.time_ns()` 生成纳秒级唯一 ID，避免同一秒内多条消息 ID 重复\n- **Hermes 侧安装说明**：`process_queue.py` 和 `communication_queue.py` 需同时安装到 Hermes skill 目录（`~/.hermes/skills/autonomous-ai-agents/hermes-communication-bridge/`），Bridge cron 才能正常工作\n- **验证通过**：双向通信延迟约 1 分钟，队列幂等处理正常\n\n### v1.0.0（2026-04-16）\n- 初始版本发布\n\nFile v1.2.0:temp-repo2/SKILL.md\n\n---\nname: hermes-comm\ndescription: \"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信\"\nversion: 1.0.0\ncategory: autonomous-ai-agents\n---\n\n# Hermes-WorkBuddy 通信桥\n\n通过 `~/.hermes/shared/communication/queue.json` 共享文件队列，WorkBuddy 与 Hermes 直接双向通信。\n\n## 核心文件\n\n- 队列：`~/.hermes/shared/communication/queue.json`\n- 历史：`~/.hermes/shared/communication/history.json`\n- 技能：`~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py`\n\n## CLI 命令\n\n```bash\n# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed\n```\n\n## 消息格式\n\n```json\n{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}\n```\n\n## 类型说明\n\n- `message`：普通文本消息\n- `task`：任务请求（带元数据）\n- `query`：查询请求\n- `response`：响应\n- `status`：状态更新\n- `file`：文件传输\n- `command`：系统命令\n- `alert`：警报通知\n\n## 工作流\n\n1. **WorkBuddy 发消息**：`send workbuddy hermes \"内容\"`\n2. **Hermes 读取**：通过 cron 或 auto_poller 轮询队列，发现 pending 消息\n3. **Hermes 回复**：写 `hermes → workbuddy` 的 pending 消息\n4. **WorkBuddy 读取**：`receive workbuddy`，处理消息\n5. **标记完成**：`mark <msg_id> completed`\n\nFile v1.2.0:temp-repo2/README.md\n\n# Hermes-WorkBuddy 通信桥\n\n> 通过共享文件队列（`queue.json`）实现 WorkBuddy 与 Hermes Agent 的双向直接通信，无需外部服务依赖。\n\n## 架构\n\n```\nWorkBuddy  ←── queue.json ──▶  Hermes\n              (每小时 cron)\n```\n\n## 核心文件\n\n| 文件 | 用途 |\n|------|------|\n| `scripts/communication_queue.py` | 队列管理器（CommunicationQueue 类） |\n| `scripts/hermes_comm.py` | WorkBuddy 侧 CLI 工具 |\n| `scripts/process_queue.py` | Hermes 侧消息处理器 |\n| `scripts/auto_poller.py` | 持续轮询脚本（测试用） |\n| `config/default_config.json` | 队列默认配置 |\n| `config/message_types.json` | 消息类型定义 |\n\n## 快速开始\n\n### WorkBuddy → Hermes 发消息\n\n```bash\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py send -c \"你好 Hermes！\"\n```\n\n### 收取 Hermes 回复\n\n```bash\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py receive\n```\n\n### Hermes 侧配置 Cron（每小时自动处理）\n\n```bash\nhermes cron create --script ~/.workbuddy/skills/hermes-communication-bridge/scripts/process_queue.py \"every 1h\"\n```\n\n## 队列存储\n\n- 队列文件：`~/.hermes/shared/communication/queue.json`\n- 历史文件：`~/.hermes/shared/communication/history.json`\n\n## 依赖\n\n- Python 3.10+\n- Hermes Agent（已安装并运行）\n\n## 许可证\n\nMIT\n\nFile v1.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn73qbrbqs4s8t2nh8pm22wxbd84vm7r\",\n  \"slug\": \"hermes-communication-bridge\",\n  \"version\": \"1.2.0\",\n  \"publishedAt\": 1776686084368\n}\n\nFile v1.2.0:skill-card.md\n\n## Description:\n\nProvides a local shared-file queue for asynchronous messages between WorkBuddy and Hermes.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[liuboacean](https://clawhub.ai/user/liuboacean)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agent operators use this skill to send, receive, inspect, and mark asynchronous queue messages between WorkBuddy and Hermes without an external service.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Messages are stored in local shared queue and history files, which can expose sensitive content to other local users or processes.\n\nMitigation: Avoid sending secrets and restrict filesystem permissions on the configured communication directory.\n\nRisk: Unattended polling can process untrusted queue contents, including command-type messages.\n\nMitigation: Treat all queue entries as untrusted and require separate confirmation before acting on command-type messages.\n\nRisk: Shared queue files do not provide authentication or authorization for multi-user or sensitive environments.\n\nMitigation: Use a safer authenticated channel or deploy only in trusted single-user environments when sensitive messages are possible.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/liuboacean/skills/hermes-communication-bridge)\n- [Publisher profile](https://clawhub.ai/user/liuboacean)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration]\n\n**Output Format:** [Markdown with inline shell commands and JSON examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May write local queue and history JSON files under the configured Hermes communication directory.]\n\n## Skill Version(s):\n\n1.2.0 (source: frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.2.0:config/default_config.json\n\n{\n  \"queue_dir\": \"/Users/liubo/.hermes/shared/communication\",\n  \"poll_interval\": 10,\n  \"max_message_age_days\": 7,\n  \"log_level\": \"INFO\",\n  \"auto_start_poller\": true\n}\n\nFile v1.2.0:config/message_types.json\n\n{\n  \"message\": {\"description\": \"普通文本消息\", \"handler\": \"handle_general_message\"},\n  \"task\": {\"description\": \"任务请求\", \"handler\": \"handle_task\"},\n  \"query\": {\"description\": \"查询请求\", \"handler\": \"handle_query\"},\n  \"response\": {\"description\": \"查询响应\", \"handler\": \"handle_response\"},\n  \"status\": {\"description\": \"状态更新\", \"handler\": \"handle_status\"},\n  \"file\": {\"description\": \"文件传输\", \"handler\": \"handle_file\"},\n  \"command\": {\"description\": \"系统命令\", \"handler\": \"handle_command\"},\n  \"alert\": {\"description\": \"警报通知\", \"handler\": \"handle_alert\"}\n}\n\nFile v1.2.0:temp-repo2/config/default_config.json\n\n{\n  \"queue_dir\": \"/Users/liubo/.hermes/shared/communication\",\n  \"poll_interval\": 10,\n  \"max_message_age_days\": 7,\n  \"log_level\": \"INFO\",\n  \"auto_start_poller\": true\n}\n\nFile v1.2.0:temp-repo2/config/message_types.json\n\n{\n  \"message\": {\"description\": \"普通文本消息\", \"handler\": \"handle_general_message\"},\n  \"task\": {\"description\": \"任务请求\", \"handler\": \"handle_task\"},\n  \"query\": {\"description\": \"查询请求\", \"handler\": \"handle_query\"},\n  \"response\": {\"description\": \"查询响应\", \"handler\": \"handle_response\"},\n  \"status\": {\"description\": \"状态更新\", \"handler\": \"handle_status\"},\n  \"file\": {\"description\": \"文件传输\", \"handler\": \"handle_file\"},\n  \"command\": {\"description\": \"系统命令\", \"handler\": \"handle_command\"},\n  \"alert\": {\"description\": \"警报通知\", \"handler\": \"handle_alert\"}\n}\n\nArchive v1.1.0: 16 files, 16009 bytes\n\nFiles: config/default_config.json (167b), config/message_types.json (597b), scripts/auto_poller.py (829b), scripts/communication_queue.py (9697b), scripts/hermes_comm.py (1734b), scripts/process_queue.py (1256b), SKILL.md (2638b), temp-repo2/config/default_config.json (167b), temp-repo2/config/message_types.json (597b), temp-repo2/README.md (1389b), temp-repo2/scripts/auto_poller.py (829b), temp-repo2/scripts/communication_queue.py (9694b), temp-repo2/scripts/hermes_comm.py (1734b), temp-repo2/scripts/process_queue.py (1256b), temp-repo2/SKILL.md (2086b), _meta.json (146b)\n\nFile v1.1.0:SKILL.md\n\n---\nname: hermes-comm\ndescription: \"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信\"\nversion: 1.1.0\ncategory: autonomous-ai-agents\n---\n\n# Hermes-WorkBuddy 通信桥\n\n通过 `~/.hermes/shared/communication/queue.json` 共享文件队列，WorkBuddy 与 Hermes 直接双向通信。\n\n## 核心文件\n\n- 队列：`~/.hermes/shared/communication/queue.json`\n- 历史：`~/.hermes/shared/communication/history.json`\n- 技能：`~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py`\n\n## CLI 命令\n\n```bash\n# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed\n```\n\n## 消息格式\n\n```json\n{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}\n```\n\n## 类型说明\n\n- `message`：普通文本消息\n- `task`：任务请求（带元数据）\n- `query`：查询请求\n- `response`：响应\n- `status`：状态更新\n- `file`：文件传输\n- `command`：系统命令\n- `alert`：警报通知\n\n## 工作流\n\n1. **WorkBuddy 发消息**：`send workbuddy hermes \"内容\"`\n2. **Hermes 读取**：通过 cron 或 auto_poller 轮询队列，发现 pending 消息\n3. **Hermes 回复**：写 `hermes → workbuddy` 的 pending 消息\n4. **WorkBuddy 读取**：`receive workbuddy`，处理消息\n5. **标记完成**：`mark <msg_id> completed`\n\n## 版本历史\n\n### v1.1.0（2026-04-16）\n- **Bug Fix**：修复消息 ID 秒级时间戳碰撞问题，改用 `time.time_ns()` 生成纳秒级唯一 ID，避免同一秒内多条消息 ID 重复\n- **Hermes 侧安装说明**：`process_queue.py` 和 `communication_queue.py` 需同时安装到 Hermes skill 目录（`~/.hermes/skills/autonomous-ai-agents/hermes-communication-bridge/`），Bridge cron 才能正常工作\n- **验证通过**：双向通信延迟约 1 分钟，队列幂等处理正常\n\n### v1.0.0（2026-04-16）\n- 初始版本发布\n\nFile v1.1.0:temp-repo2/SKILL.md\n\n---\nname: hermes-comm\ndescription: \"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信\"\nversion: 1.0.0\ncategory: autonomous-ai-agents\n---\n\n# Hermes-WorkBuddy 通信桥\n\n通过 `~/.hermes/shared/communication/queue.json` 共享文件队列，WorkBuddy 与 Hermes 直接双向通信。\n\n## 核心文件\n\n- 队列：`~/.hermes/shared/communication/queue.json`\n- 历史：`~/.hermes/shared/communication/history.json`\n- 技能：`~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py`\n\n## CLI 命令\n\n```bash\n# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed\n```\n\n## 消息格式\n\n```json\n{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}\n```\n\n## 类型说明\n\n- `message`：普通文本消息\n- `task`：任务请求（带元数据）\n- `query`：查询请求\n- `response`：响应\n- `status`：状态更新\n- `file`：文件传输\n- `command`：系统命令\n- `alert`：警报通知\n\n## 工作流\n\n1. **WorkBuddy 发消息**：`send workbuddy hermes \"内容\"`\n2. **Hermes 读取**：通过 cron 或 auto_poller 轮询队列，发现 pending 消息\n3. **Hermes 回复**：写 `hermes → workbuddy` 的 pending 消息\n4. **WorkBuddy 读取**：`receive workbuddy`，处理消息\n5. **标记完成**：`mark <msg_id> completed`\n\nFile v1.1.0:temp-repo2/README.md\n\n# Hermes-WorkBuddy 通信桥\n\n> 通过共享文件队列（`queue.json`）实现 WorkBuddy 与 Hermes Agent 的双向直接通信，无需外部服务依赖。\n\n## 架构\n\n```\nWorkBuddy  ←── queue.json ──▶  Hermes\n              (每小时 cron)\n```\n\n## 核心文件\n\n| 文件 | 用途 |\n|------|------|\n| `scripts/communication_queue.py` | 队列管理器（CommunicationQueue 类） |\n| `scripts/hermes_comm.py` | WorkBuddy 侧 CLI 工具 |\n| `scripts/process_queue.py` | Hermes 侧消息处理器 |\n| `scripts/auto_poller.py` | 持续轮询脚本（测试用） |\n| `config/default_config.json` | 队列默认配置 |\n| `config/message_types.json` | 消息类型定义 |\n\n## 快速开始\n\n### WorkBuddy → Hermes 发消息\n\n```bash\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py send -c \"你好 Hermes！\"\n```\n\n### 收取 Hermes 回复\n\n```bash\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py receive\n```\n\n### Hermes 侧配置 Cron（每小时自动处理）\n\n```bash\nhermes cron create --script ~/.workbuddy/skills/hermes-communication-bridge/scripts/process_queue.py \"every 1h\"\n```\n\n## 队列存储\n\n- 队列文件：`~/.hermes/shared/communication/queue.json`\n- 历史文件：`~/.hermes/shared/communication/history.json`\n\n## 依赖\n\n- Python 3.10+\n- Hermes Agent（已安装并运行）\n\n## 许可证\n\nMIT\n\nFile v1.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn73qbrbqs4s8t2nh8pm22wxbd84vm7r\",\n  \"slug\": \"hermes-communication-bridge\",\n  \"version\": \"1.1.0\",\n  \"publishedAt\": 1776345841866\n}\n\nFile v1.1.0:config/default_config.json\n\n{\n  \"queue_dir\": \"/Users/liubo/.hermes/shared/communication\",\n  \"poll_interval\": 10,\n  \"max_message_age_days\": 7,\n  \"log_level\": \"INFO\",\n  \"auto_start_poller\": true\n}\n\nFile v1.1.0:config/message_types.json\n\n{\n  \"message\": {\"description\": \"普通文本消息\", \"handler\": \"handle_general_message\"},\n  \"task\": {\"description\": \"任务请求\", \"handler\": \"handle_task\"},\n  \"query\": {\"description\": \"查询请求\", \"handler\": \"handle_query\"},\n  \"response\": {\"description\": \"查询响应\", \"handler\": \"handle_response\"},\n  \"status\": {\"description\": \"状态更新\", \"handler\": \"handle_status\"},\n  \"file\": {\"description\": \"文件传输\", \"handler\": \"handle_file\"},\n  \"command\": {\"description\": \"系统命令\", \"handler\": \"handle_command\"},\n  \"alert\": {\"description\": \"警报通知\", \"handler\": \"handle_alert\"}\n}\n\nFile v1.1.0:temp-repo2/config/default_config.json\n\n{\n  \"queue_dir\": \"/Users/liubo/.hermes/shared/communication\",\n  \"poll_interval\": 10,\n  \"max_message_age_days\": 7,\n  \"log_level\": \"INFO\",\n  \"auto_start_poller\": true\n}\n\nFile v1.1.0:temp-repo2/config/message_types.json\n\n{\n  \"message\": {\"description\": \"普通文本消息\", \"handler\": \"handle_general_message\"},\n  \"task\": {\"description\": \"任务请求\", \"handler\": \"handle_task\"},\n  \"query\": {\"description\": \"查询请求\", \"handler\": \"handle_query\"},\n  \"response\": {\"description\": \"查询响应\", \"handler\": \"handle_response\"},\n  \"status\": {\"description\": \"状态更新\", \"handler\": \"handle_status\"},\n  \"file\": {\"description\": \"文件传输\", \"handler\": \"handle_file\"},\n  \"command\": {\"description\": \"系统命令\", \"handler\": \"handle_command\"},\n  \"alert\": {\"description\": \"警报通知\", \"handler\": \"handle_alert\"}\n}\n\nArchive v1.0.0: 16 files, 15715 bytes\n\nFiles: config/default_config.json (167b), config/message_types.json (597b), scripts/auto_poller.py (829b), scripts/communication_queue.py (9694b), scripts/hermes_comm.py (1734b), scripts/process_queue.py (1256b), SKILL.md (2086b), temp-repo2/config/default_config.json (167b), temp-repo2/config/message_types.json (597b), temp-repo2/README.md (1389b), temp-repo2/scripts/auto_poller.py (829b), temp-repo2/scripts/communication_queue.py (9694b), temp-repo2/scripts/hermes_comm.py (1734b), temp-repo2/scripts/process_queue.py (1256b), temp-repo2/SKILL.md (2086b), _meta.json (146b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: hermes-comm\ndescription: \"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信\"\nversion: 1.0.0\ncategory: autonomous-ai-agents\n---\n\n# Hermes-WorkBuddy 通信桥\n\n通过 `~/.hermes/shared/communication/queue.json` 共享文件队列，WorkBuddy 与 Hermes 直接双向通信。\n\n## 核心文件\n\n- 队列：`~/.hermes/shared/communication/queue.json`\n- 历史：`~/.hermes/shared/communication/history.json`\n- 技能：`~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py`\n\n## CLI 命令\n\n```bash\n# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed\n```\n\n## 消息格式\n\n```json\n{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}\n```\n\n## 类型说明\n\n- `message`：普通文本消息\n- `task`：任务请求（带元数据）\n- `query`：查询请求\n- `response`：响应\n- `status`：状态更新\n- `file`：文件传输\n- `command`：系统命令\n- `alert`：警报通知\n\n## 工作流\n\n1. **WorkBuddy 发消息**：`send workbuddy hermes \"内容\"`\n2. **Hermes 读取**：通过 cron 或 auto_poller 轮询队列，发现 pending 消息\n3. **Hermes 回复**：写 `hermes → workbuddy` 的 pending 消息\n4. **WorkBuddy 读取**：`receive workbuddy`，处理消息\n5. **标记完成**：`mark <msg_id> completed`\n\nFile v1.0.0:temp-repo2/SKILL.md\n\n---\nname: hermes-comm\ndescription: \"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信\"\nversion: 1.0.0\ncategory: autonomous-ai-agents\n---\n\n# Hermes-WorkBuddy 通信桥\n\n通过 `~/.hermes/shared/communication/queue.json` 共享文件队列，WorkBuddy 与 Hermes 直接双向通信。\n\n## 核心文件\n\n- 队列：`~/.hermes/shared/communication/queue.json`\n- 历史：`~/.hermes/shared/communication/history.json`\n- 技能：`~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py`\n\n## CLI 命令\n\n```bash\n# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed\n```\n\n## 消息格式\n\n```json\n{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}\n```\n\n## 类型说明\n\n- `message`：普通文本消息\n- `task`：任务请求（带元数据）\n- `query`：查询请求\n- `response`：响应\n- `status`：状态更新\n- `file`：文件传输\n- `command`：系统命令\n- `alert`：警报通知\n\n## 工作流\n\n1. **WorkBuddy 发消息**：`send workbuddy hermes \"内容\"`\n2. **Hermes 读取**：通过 cron 或 auto_poller 轮询队列，发现 pending 消息\n3. **Hermes 回复**：写 `hermes → workbuddy` 的 pending 消息\n4. **WorkBuddy 读取**：`receive workbuddy`，处理消息\n5. **标记完成**：`mark <msg_id> completed`\n\nFile v1.0.0:temp-repo2/README.md\n\n# Hermes-WorkBuddy 通信桥\n\n> 通过共享文件队列（`queue.json`）实现 WorkBuddy 与 Hermes Agent 的双向直接通信，无需外部服务依赖。\n\n## 架构\n\n```\nWorkBuddy  ←── queue.json ──▶  Hermes\n              (每小时 cron)\n```\n\n## 核心文件\n\n| 文件 | 用途 |\n|------|------|\n| `scripts/communication_queue.py` | 队列管理器（CommunicationQueue 类） |\n| `scripts/hermes_comm.py` | WorkBuddy 侧 CLI 工具 |\n| `scripts/process_queue.py` | Hermes 侧消息处理器 |\n| `scripts/auto_poller.py` | 持续轮询脚本（测试用） |\n| `config/default_config.json` | 队列默认配置 |\n| `config/message_types.json` | 消息类型定义 |\n\n## 快速开始\n\n### WorkBuddy → Hermes 发消息\n\n```bash\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py send -c \"你好 Hermes！\"\n```\n\n### 收取 Hermes 回复\n\n```bash\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py receive\n```\n\n### Hermes 侧配置 Cron（每小时自动处理）\n\n```bash\nhermes cron create --script ~/.workbuddy/skills/hermes-communication-bridge/scripts/process_queue.py \"every 1h\"\n```\n\n## 队列存储\n\n- 队列文件：`~/.hermes/shared/communication/queue.json`\n- 历史文件：`~/.hermes/shared/communication/history.json`\n\n## 依赖\n\n- Python 3.10+\n- Hermes Agent（已安装并运行）\n\n## 许可证\n\nMIT\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn73qbrbqs4s8t2nh8pm22wxbd84vm7r\",\n  \"slug\": \"hermes-communication-bridge\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1776323479845\n}\n\nFile v1.0.0:config/default_config.json\n\n{\n  \"queue_dir\": \"/Users/liubo/.hermes/shared/communication\",\n  \"poll_interval\": 10,\n  \"max_message_age_days\": 7,\n  \"log_level\": \"INFO\",\n  \"auto_start_poller\": true\n}\n\nFile v1.0.0:config/message_types.json\n\n{\n  \"message\": {\"description\": \"普通文本消息\", \"handler\": \"handle_general_message\"},\n  \"task\": {\"description\": \"任务请求\", \"handler\": \"handle_task\"},\n  \"query\": {\"description\": \"查询请求\", \"handler\": \"handle_query\"},\n  \"response\": {\"description\": \"查询响应\", \"handler\": \"handle_response\"},\n  \"status\": {\"description\": \"状态更新\", \"handler\": \"handle_status\"},\n  \"file\": {\"description\": \"文件传输\", \"handler\": \"handle_file\"},\n  \"command\": {\"description\": \"系统命令\", \"handler\": \"handle_command\"},\n  \"alert\": {\"description\": \"警报通知\", \"handler\": \"handle_alert\"}\n}\n\nFile v1.0.0:temp-repo2/config/default_config.json\n\n{\n  \"queue_dir\": \"/Users/liubo/.hermes/shared/communication\",\n  \"poll_interval\": 10,\n  \"max_message_age_days\": 7,\n  \"log_level\": \"INFO\",\n  \"auto_start_poller\": true\n}\n\nFile v1.0.0:temp-repo2/config/message_types.json\n\n{\n  \"message\": {\"description\": \"普通文本消息\", \"handler\": \"handle_general_message\"},\n  \"task\": {\"description\": \"任务请求\", \"handler\": \"handle_task\"},\n  \"query\": {\"description\": \"查询请求\", \"handler\": \"handle_query\"},\n  \"response\": {\"description\": \"查询响应\", \"handler\": \"handle_response\"},\n  \"status\": {\"description\": \"状态更新\", \"handler\": \"handle_status\"},\n  \"file\": {\"description\": \"文件传输\", \"handler\": \"handle_file\"},\n  \"command\": {\"description\": \"系统命令\", \"handler\": \"handle_command\"},\n  \"alert\": {\"description\": \"警报通知\", \"handler\": \"handle_alert\"}\n}","readmeExcerpt":"Skill: Hermes Communication Bridge Owner: liuboacean Summary: WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信、队列消息、异步通信 Tags: AI-Agents:1.0.0, Communication:1.0.0, latest:1.2.0 Version history: v1.2.0 | 2026-04-20T11:54:44.368Z | auto - Enhanced documentation with notes distinguishing the queue bridge from the event-driven hermes-memory-bridge system, including migration advice. - Updated descr","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed"},{"language":"json","snippet":"{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}"},{"language":"bash","snippet":"# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed"},{"language":"json","snippet":"{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}"},{"language":"text","snippet":"WorkBuddy  ←── queue.json ──▶  Hermes\n              (每小时 cron)"},{"language":"bash","snippet":"python3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py send -c \"你好 Hermes！\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: hermes-comm\ndescription: \"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信、队列消息、异步通信\"\nversion: 1.2.0\ncategory: autonomous-ai-agents\n---\n\n# Hermes-WorkBuddy 通信桥\n\n> **v1.x 注意**：此为队列式通信桥（queue.json）。如需更强大的**事件驱动闭环命令系统**，请改用 `hermes-memory-bridge` v2.0（`~/.workbuddy/skills/hermes-memory-bridge/`）。两者可并存，各司其职。\n\n通过 `~/.hermes/shared/communication/queue.json` 共享文件队列，WorkBuddy 与 Hermes 直接双向通信。\n\n## 核心文件\n\n- 队列：`~/.hermes/shared/communication/queue.json`\n- 历史：`~/.hermes/shared/communication/history.json`\n- 技能：`~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py`\n\n## CLI 命令\n\n```bash\n# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed\n```\n\n## 消息格式\n\n```json\n{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}\n```\n\n## 类型说明\n\n- `message`：普通文本消息\n- `task`：任务请求（带元数据）\n- `query`：查询请求\n- `response`：响应\n- `status`：状态更新\n- `file`：文件传输\n- `command`：系统命令\n- `alert`：警报通知\n\n## 工作流\n\n1. **WorkBuddy 发消息**：`send workbuddy hermes \"内容\"`\n2. **Hermes 读取**：通过 cron 或 auto_poller 轮询队列，发现 pending 消息\n3. **Hermes 回复**：写 `hermes → workbuddy` 的 pending 消息\n4. **WorkBuddy 读取**：`receive workbuddy`，处理消息\n5. **标记完成**：`mark <msg_id> completed`\n\n## 版本历史\n\n### v1.1.0（2026-04-16）\n- **Bug Fix**：修复消息 ID 秒级时间戳碰撞问题，改用 `time.time_ns()` 生成纳秒级唯一 ID，避免同一秒内多条消息 ID 重复\n- **Hermes 侧安装说明**：`process_queue.py` 和 `communication_queue.py` 需同时安装到 Hermes skill 目录（`~/.hermes/skills/autonomous-ai-agents/hermes-communication-bridge/`），Bridge cron 才能正常工作\n- **验证通过**：双向通信延迟约 1 分钟，队列幂等处理正常\n\n### v1.0.0（2026-04-16）\n- 初始版本发布"},{"path":"temp-repo2/SKILL.md","content":"---\nname: hermes-comm\ndescription: \"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信\"\nversion: 1.0.0\ncategory: autonomous-ai-agents\n---\n\n# Hermes-WorkBuddy 通信桥\n\n通过 `~/.hermes/shared/communication/queue.json` 共享文件队列，WorkBuddy 与 Hermes 直接双向通信。\n\n## 核心文件\n\n- 队列：`~/.hermes/shared/communication/queue.json`\n- 历史：`~/.hermes/shared/communication/history.json`\n- 技能：`~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py`\n\n## CLI 命令\n\n```bash\n# WorkBuddy → Hermes 发消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes \"内容\"\n\n# 收 Hermes → WorkBuddy 的消息\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy\n\n# 查看队列统计\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats\n\n# 标记消息已处理\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed\n```\n\n## 消息格式\n\n```json\n{\n  \"id\": \"msg_<timestamp>_<sender>\",\n  \"sender\": \"workbuddy|hermes\",\n  \"receiver\": \"hermes|workbuddy\",\n  \"type\": \"message|task|query|response|status|file|command|alert\",\n  \"content\": \"消息内容\",\n  \"priority\": \"low|normal|high|urgent\",\n  \"status\": \"pending|processing|completed|failed\"\n}\n```\n\n## 类型说明\n\n- `message`：普通文本消息\n- `task`：任务请求（带元数据）\n- `query`：查询请求\n- `response`：响应\n- `status`：状态更新\n- `file`：文件传输\n- `command`：系统命令\n- `alert`：警报通知\n\n## 工作流\n\n1. **WorkBuddy 发消息**：`send workbuddy hermes \"内容\"`\n2. **Hermes 读取**：通过 cron 或 auto_poller 轮询队列，发现 pending 消息\n3. **Hermes 回复**：写 `hermes → workbuddy` 的 pending 消息\n4. **WorkBuddy 读取**：`receive workbuddy`，处理消息\n5. **标记完成**：`mark <msg_id> completed`"},{"path":"temp-repo2/README.md","content":"# Hermes-WorkBuddy 通信桥\n\n> 通过共享文件队列（`queue.json`）实现 WorkBuddy 与 Hermes Agent 的双向直接通信，无需外部服务依赖。\n\n## 架构\n\n```\nWorkBuddy  ←── queue.json ──▶  Hermes\n              (每小时 cron)\n```\n\n## 核心文件\n\n| 文件 | 用途 |\n|------|------|\n| `scripts/communication_queue.py` | 队列管理器（CommunicationQueue 类） |\n| `scripts/hermes_comm.py` | WorkBuddy 侧 CLI 工具 |\n| `scripts/process_queue.py` | Hermes 侧消息处理器 |\n| `scripts/auto_poller.py` | 持续轮询脚本（测试用） |\n| `config/default_config.json` | 队列默认配置 |\n| `config/message_types.json` | 消息类型定义 |\n\n## 快速开始\n\n### WorkBuddy → Hermes 发消息\n\n```bash\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py send -c \"你好 Hermes！\"\n```\n\n### 收取 Hermes 回复\n\n```bash\npython3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py receive\n```\n\n### Hermes 侧配置 Cron（每小时自动处理）\n\n```bash\nhermes cron create --script ~/.workbuddy/skills/hermes-communication-bridge/scripts/process_queue.py \"every 1h\"\n```\n\n## 队列存储\n\n- 队列文件：`~/.hermes/shared/communication/queue.json`\n- 历史文件：`~/.hermes/shared/communication/history.json`\n\n## 依赖\n\n- Python 3.10+\n- Hermes Agent（已安装并运行）\n\n## 许可证\n\nMIT"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn73qbrbqs4s8t2nh8pm22wxbd84vm7r\",\n  \"slug\": \"hermes-communication-bridge\",\n  \"version\": \"1.2.0\",\n  \"publishedAt\": 1776686084368\n}"},{"path":"skill-card.md","content":"## Description:\n\nProvides a local shared-file queue for asynchronous messages between WorkBuddy and Hermes.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[liuboacean](https://clawhub.ai/user/liuboacean)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agent operators use this skill to send, receive, inspect, and mark asynchronous queue messages between WorkBuddy and Hermes without an external service.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Messages are stored in local shared queue and history files, which can expose sensitive content to other local users or processes.\n\nMitigation: Avoid sending secrets and restrict filesystem permissions on the configured communication directory.\n\nRisk: Unattended polling can process untrusted queue contents, including command-type messages.\n\nMitigation: Treat all queue entries as untrusted and require separate confirmation before acting on command-type messages.\n\nRisk: Shared queue files do not provide authentication or authorization for multi-user or sensitive environments.\n\nMitigation: Use a safer authenticated channel or deploy only in trusted single-user environments when sensitive messages are possible.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/liuboacean/skills/hermes-communication-bridge)\n- [Publisher profile](https://clawhub.ai/user/liuboacean)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration]\n\n**Output Format:** [Markdown with inline shell commands and JSON examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May write local queue and history JSON files under the configured Hermes communication directory.]\n\n## Skill Version(s):\n\n1.2.0 (source: frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信、队列消息、异步通信 Skill: Hermes Communication Bridge Owner: liuboacean Summary: WorkBuddy 与 Hermes 之间通过共享文件队列直接通信。触发词：发消息给hermes、收hermes消息、查看通信队列、双向通信、队列消息、异步通信 Tags: AI-Agents:1.0.0, Communication:1.0.0, latest:1.2.0 Version history: v1.2.0 | 2026-04-20T11:54:44.368Z | auto - Enhanced documentation with notes distinguishing the queue bridge from the event-driven hermes-memory-bridge system, including migration advice. - Updated descr","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":980,"uniquenessScore":48,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T09:03:51.380Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T09:03:51.380Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:26:13.646Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}