[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76XWD58E7K4CMMBYWP7SM3C":3,"skill-same:01M76XWD58E7K4CMMBYWP7SM3C":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":39,"commitSha":40,"skillDirectory":41,"forksCount":42,"repositoryHtmlUrl":43,"repositoryHomepageUrl":44,"ownerHtmlUrl":45,"ownerBlogUrl":6,"ownerDescription":46,"updatedAt":47,"install":48,"resources":60},"01M76XWD58E7K4CMMBYWP7SM3C","agent-comm-hub",null,"多智能体消息转发与上下文共享中间件 — 基于 MCP 协议实现 agent 间通信与任务协同。支持多 Agent 接入，提供标准 MCP 工具接口和本地 SQLite 存储。","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fa\u002Fagent-comm-hub\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: agent-comm-hub\ndescription: \"多智能体消息转发与上下文共享中间件 — 基于 MCP 协议实现 agent 间通信与任务协同。支持多 Agent 接入，提供标准 MCP 工具接口和本地 SQLite 存储。\"\nversion: \"2.4.5\"\ncategory: autonomous-ai-agents\ntriggers:\n  - \"hub\"\n  - \"Hub\"\n  - \"agent-comm-hub\"\n  - \"通信\"\n  - \"消息\"\n  - \"workbuddy\"\n  - \"QClaw\"\n  - \"send_message\"\n  - \"assign_task\"\nenv:\n  HUB_KEY:\n    description: \"stdio mode connection key for agent authentication\"\n    required: true\n    secret: true\n---\n\n# Agent Communication Hub\n\n> 多智能体消息转发与上下文共享中间件 — **v2.4.5**\n\n让两个或多个独立 AI 智能体之间实现**实时双向通信**和**上下文自动同步**。基于 MCP 协议 + stdio 模式，消息本地持久化，延迟 \u003C 50ms。\n\n## 架构概览\n\n```\n┌──────────────┐         ┌──────────────────────────────┐         ┌──────────────┐\n│   Agent A    │  SSE    │   Agent Communication Hub    │  SSE    │   Agent B    │\n│  (Hermes)    │◄───────►│  (stdio)                    │◄───────►│ (WorkBuddy)  │\n│              │  MCP    │                              │  MCP    │              │\n└──────────────┘◄───────►│  SQLite WAL + 30 表          │◄───────►└──────────────┘\n                          │  53 MCP 工具 + 4 级权限     │\n                          │  上下文暂存 + 建议闭环       │\n                          └──────────────┬──────────────┘\n                                         │\n                                    SQLite (WAL)\n```\n\n**三层协议**：\n\n| 层 | 协议 | 用途 | 延迟 |\n|----|------|------|------|\n| MCP 工具层 | stdio JSON-RPC | 结构化操作（发消息、分配任务、查状态） | \u003C50ms |\n| SSE 推送层 | Server-Sent Events | 实时事件通知（新消息、新任务、建议确认） | \u003C50ms |\n\n## 快速上手 (5 分钟)\n\n从零到完成第一次 Agent 间通信的编号流程：\n\n### Step 1: 确认 Hub 运行状态\n\n确认 Agent Communication Hub 服务器正在运行。如果通过 stdio 模式接入，检查 MCP 配置是否正确加载：\n\n```\n调用: get_online_agents()\n期望: 返回在线 Agent 列表（至少含自己）\n失败: Hub 未运行 → 先启动 Hub 服务器\n```\n\n**[检查点] 用户确认**：如果 Hub 未运行，询问用户是否要启动 Hub 服务器。\n\n### Step 2: 注册或确认身份\n\n检查自己是否已在 Hub 注册，如果没有则注册：\n\n```\n1. 调用: query_agents(status='all') → 查看所有 Agent\n2. 如果自己的 Agent ID 不在列表中\n   → register_agent(invite_code, name, capabilities)\n3. 如果已注册 → 记下自己的 agent_id 供后续使用\n```\n\n**[检查点] 用户确认**：注册新 Agent 需要 invite_code，先问用户是否有可用的邀请码。\n\n### Step 3: 维持在线状态\n\n启动心跳维持在线，确保能接收实时消息推送：\n\n```\n调用: heartbeat(agent_id='你的ID')\n频率: 每 30 秒一次（超过 90 秒无心跳则自动标记为离线）\n```\n\n### Step 4: 检查未读消息\n\n上线后第一时间检查是否有离线期间缓存的消息：\n\n```\n1. 调用: search_messages(query='你的ID', limit=20)\n2. 筛选 status='unread' 的消息\n3. 按时间顺序处理，先 acknowledge_message 确认收到，再回复\n```\n\n**[检查点] 用户确认**：找到未读消息后，逐条向用户摘要汇报，请用户确认如何处理。\n\n### Step 5: 发送第一条消息\n\n向另一个 Agent 发送消息，验证双向通信：\n\n```\n调用: send_message(from='你的ID', to='目标AgentID', content='通信链路确认畅通')\n检查返回: delivered_realtime — true=对方在线, false=对方离线\n```\n\n**[检查点] 用户确认**：发送前向用户确认消息内容和目标 Agent。broadcast_message 必须逐条确认。\n\n### 完整闭环示例\n\n```\n场景：Hub 在线 → 检查 WorkBuddy 是否有未读消息 → 处理并回复\n\n1. get_online_agents()                    # 确认自己和对方在线\n2. search_messages(limit=10)              # 查最近消息\n3. acknowledge_message(msg_id, agent_id)  # 标记已读\n4. send_message(to='workbuddy', content='已收到，正在处理')  # 回复\n5. mark_consumed(resource=msg_id, action='replied')  # 消费水位线\n```\n\n## 核心能力\n\n### 53 个 MCP 工具（v2.4.0）\n\n#### Identity 身份 (6)\n\n| 工具 | 功能 |\n|------|------|\n| `register_agent` | 注册新 Agent，需提供 HUB_KEY 认证 |\n| `heartbeat` | Agent 心跳上报，维持在线状态，每 3 次连续心跳记录 +1 |\n| `query_agents` | 查询 Agent 列表，支持状态\u002F角色筛选 |\n| `get_online_agents` | 获取当前在线 Agent 列表 |\n\n#### Message 消息 (5)\n\n| 工具 | 功能 |\n|------|------|\n| `send_message` | Agent 间点对点消息，支持 Markdown，自动去重（sha256） |\n| `broadcast_message` | (需逐条确认后发送) |\n| `acknowledge_message` | 确认已读消息，防止重复出现 |\n| `search_messages` | 全文搜索消息历史 |\n| `batch_acknowledge_messages` | 批量确认消息（1-500 条\u002F次），用于清理消息积压 |\n\n#### File 文件 (3)\n\n| 工具 | 功能 |\n|------|------|\n| `send_file` | 发送文件附件（Base64，10MB 限制），关联到消息 |\n| `receive_file` | 接收附件，返回 Base64 编码内容 |\n| `list_attachments` | 列出附件，支持按消息\u002FAgent 筛选 |\n\n#### Task 任务 (3)\n\n| 工具 | 功能 |\n|------|------|\n| `assign_task` | 创建并分配任务，支持上下文传递 |\n| `update_task_status` | 更新任务状态（inbox→assigned→in_progress→completed\u002Ffailed） |\n| `get_task_status` | 查询任务详情，含依赖、Pipeline、交接信息 |\n\n#### Context 上下文暂存 (5)\n\n| 工具 | 功能 |\n|------|------|\n| `store_memory` | 临时暂存当前任务参考信息 |\n| `recall_memory` | 检索已暂存的上下文 |\n| `list_memories` | 列出当前 Agent 的暂存条目 |\n| `delete_memory` | 删除暂存条目（仅 creator） |\n| `search_memories` | 检索当前 Agent 的暂存内容 |\n\n#### 经验记录\n\n经验记录和策略管理需特定权限配置。\n\n#### 任务协同\n\n| 工具 | 功能 |\n|------|------|\n| `add_dependency` | 添加任务依赖关系（依赖检查） |\n| `remove_dependency` | 删除任务依赖关系 |\n| `get_task_dependencies` | 查询任务上下游依赖 |\n| `create_parallel_group` | 创建并行任务组（2-10 个任务） |\n| `request_handoff` | 请求任务交接 |\n| `accept_handoff` | 接受任务交接 |\n| `reject_handoff` | 拒绝任务交接（含理由） |\n| `add_quality_gate` | 在 Pipeline 中添加质量门 |\n| `evaluate_quality_gate` | 评估质量门（passed\u002Ffailed） |\n| `recalculate_trust_scores` | 按调度执行分数维护 |\n| `create_pipeline` | 创建 Pipeline 流水线 |\n| `get_pipeline` | 查询 Pipeline 详情 |\n| `list_pipelines` | 列出 Pipeline |\n| `add_task_to_pipeline` | 向 Pipeline 添加任务 |\n\n#### 运维工具 (4)\n\n| 工具 | 功能 |\n|------|------|\n| `get_db_stats` | 数据库统计信息（表行数、大小、Agent 数等） |\n| `archive_data` | 数据维护工具 |\n| （其余 2 个内部工具） | 权限验证与控制 |\n| （其余 2 个内部工具） | 权限验证与控制 |\n\n#### 消费水位线 (2)\n\n| 工具 | 功能 |\n|------|------|\n| `mark_consumed` | 标记任务\u002F消息为已消费，防止重复处理 |\n| `check_consumed` | 查询资源是否已被消费 |\n\n> 所有工具内置 try-catch + 3 次指数退避重试（100ms → 200ms → 400ms）。v2.4.0 统一错误格式：`HubError` 错误码 + `mcpError()`\u002F`mcpFail()` 标准返回。`check_consumed` 查询失败时降级返回 `consumed=false`（不阻塞业务）。\n\n### 任务状态机\n\n```\ninbox → assigned → [waiting] → in_progress → completed \u002F failed \u002F cancelled\n```\n\n## 用户确认检查点\n\n以下操作必须在执行前暂停，向用户摘要说明并等待确认：\n\n| # | 操作 | 检查点说明 | 风险 |\n|---|------|-----------|------|\n| 1 | **broadcast_message** | 广播消息会发送给多个 Agent，逐条确认内容和接收列表 | 高 |\n| 2 | **assign_task** | 分配任务前确认：描述是否清晰、目标 Agent 是否合适、Priority 正确 | 中 |\n| 3 | **batch_acknowledge_messages** | 批量确认会一次性标记多条消息为已处理，确认不会遗漏重要信息 | 中 |\n| 4 | **create_pipeline** | 创建流水线前确认任务顺序、质量门设置、参与 Agent | 中 |\n| 5 | **add_quality_gate** | 质量门失败会阻塞后续任务，确认评估标准合理 | 高 |\n| 6 | **request_handoff** | 交接任务前确认目标 Agent 有能力接手、理由充分 | 中 |\n| 7 | **archive_data** | 归档操作会移动数据到归档表，确认归档范围和天数 | 高 |\n| 8 | **store_memory(scope='group')** | 写入组内共享记忆前确认内容适当，不会泄露敏感信息 | 中 |\n| 9 | **propose_strategy** | 提议策略前确认内容准确、分类正确、有实际价值 | 低 |\n| 10 | **reject_handoff** | 拒绝交接需提供理由，确认不会导致任务阻塞 | 中 |\n\n> **规则**：LLM 遇到上表操作时，先向用户输出摘要说明，明确询问\"是否继续？\"，得到肯定答复后再执行。用户可随时跳过检查点。\n\n## 数据隔离与安全边界\n\n| 边界 | 实现方式 |\n|------|---------|\n| **接收方校验** | `send_message`\u002F`assign_task` 中的 `to_agent` 必须为已注册 Agent，未注册 Agent 被拒绝 |\n| **Per-Agent 数据隔离** | 每个 Agent 仅可见自身消息、任务和暂存条目；跨 Agent 查询受 4 级权限控制 |\n| **暂存内容保护** | `store_memory` 创建的条目仅 creator 可检索和删除，不会自动暴露给其他 Agent |\n| **经验记录审批** | `share_experience` 提交的记录需经 `full` 权限确认后才对其他 Agent 可见 |\n\n## 接入配置（stdio 模式）\n\n在 MCP 配置文件中添加 Hub 为 stdio 服务器，提供 `HUB_KEY` 环境变量进行认证。Hub 通过 stdio 传输 MCP 协议，Agent 的 LLM 可直接调用 Hub 工具。\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-comm-hub\": {\n      \"command\": \"node\",\n      \"args\": [\"\u003Chub-install-path>\u002Fstdio.js\"],\n      \"env\": {\n        \"HUB_KEY\": \"your-connection-key\"\n      }\n    }\n  }\n}\n```\n\n## 资源索引\n\n此 skill 目录下已有 Hub 完整源码，可直接参考：\n\n### 本地源文件\n\n| 文件 | 用途 |\n|------|------|\n| `src\u002Fserver.ts` | 服务端入口，Express + MCP\u002FSSE 双通道 |\n| `src\u002Ftools.ts` | 全部 MCP 工具的 TypeScript 实现 |\n| `src\u002Fdb.ts` | SQLite WAL 数据库初始化与连接 |\n| `src\u002Fidentity.ts` | Agent 注册、认证、4 级权限控制 |\n| `src\u002Fdedup.ts` | SHA256 消息去重实现 |\n| `src\u002Ferrors.ts` | HubError 统一错误码（v2.4.0+） |\n| `src\u002Fstdio.ts` | Stdio 模式传输层 |\n| `src\u002Fsse.ts` | SSE 推送通道 |\n| `src\u002Forchestrator.ts` | 任务编排、Pipeline、质量门 |\n| `src\u002Fevolution.ts` | Evolution Engine：策略\u002F经验\u002F信任分 |\n| `src\u002Fmemory.ts` | 上下文暂存与管理 |\n| `src\u002Fsecurity.ts` | 安全验证、CORS、Token 管理 |\n| `src\u002Fmetrics.ts` | 统计指标收集 |\n| `src\u002Frepo\u002F` | 数据访问层（repository pattern） |\n| `package.json` | Node.js 依赖与版本定义 |\n\n### 参考链接\n\n- GitHub 仓库: https:\u002F\u002Fgithub.com\u002Fliuboacean\u002Fagent-comm-hub\n- MCP 协议规范: https:\u002F\u002Fspec.modelcontextprotocol.io\n\n## 权限说明（4 级）\n\n| 级别 | 说明 | 可用工具范围 |\n|------|------|----------|\n| **authenticated** | 已认证（HUB_KEY） | register_agent（初始注册） |\n| **member** | 已注册 Agent | 消息 `send_message`\u002F`acknowledge_message` + 任务 `assign_task`\u002F`get_task_status` |\n| **group_manager** | 并行组管理 | 任务协同 + Pipeline 工具（不含暂存\u002F经验） |\n| **full** | 完整权限 | 全部工具（含运维与建议管理） |\n\n> 部分管理类工具仅特定权限可调用，具体以实际角色配置为准。\n\n> 初始分数 50，公式：`base(50) + verified_capabilities*3 + approved_strategies*2 + positive_feedback*1 - negative_feedback*2`，clamp(0,100)。\n\n## v2.4.0 更新要点\n\n| Phase | 内容 | 变更 |\n|-------|------|------|\n| **A** | tools.ts 拆分 | 2687 行 → 8 模块 + 30 行入口 + utils.ts |\n| **B** | 单元测试 | 100 用例，role-control >= 70% \u002F dedup branches>=60, functions>=70 \u002F utils 100% |\n| **C** | CI\u002FCD | GitHub Actions：typecheck + test + coverage 3 Jobs |\n| **D** | 类型健壮 | any 归零 + HubError 统一错误码 + MCP 返回格式标准化 |\n\n## 踩坑经验速查\n\n| # | 场景 | 要点 |\n|---|------|------|\n| 1 | MCP 多 Client | 必须用 Stateless 模式，Stateful 只允许一个 Client |\n| 2 | MCP Accept Header | 必须带 `Accept: application\u002Fjson, text\u002Fevent-stream` |\n| 3 | MCP 响应格式 | SDK 返回 SSE 格式（`data: {...}`），不是纯 JSON |\n| 4 | ESM 兼容 | 不能用 `require()`，用 `import()` 动态导入 |\n| 5 | UTF-8 块读取 | httpx `resp.read(1)` 会截断多字节字符，用 `read(4096)` |\n| 6 | SSE 心跳 | 10 秒间隔，服务端发 `: ping` |\n| 7 | MCP != SSE | MCP 是工具调用通道（Agent→Hub），SSE 是推送通道（Hub→Agent） |\n| 8 | 离线补发 | 消息\u002F任务存 SQLite，上线后 SSE 自动批量推送 |\n| 9 | stdio 模式 | 所有日志走 stderr，stdout 保留给 JSON-RPC |\n| 10 | better-sqlite3 boolean | 绑定参数必须用 1\u002F0，不能用 true\u002Ffalse |\n| 11 | HubError 错误码 | v2.4.0 统一用 mcpError()\u002FmcpFail()，不要手动构造错误响应 |\n\n## 安全配置\n\n| 配置项 | 说明 |\n|--------|------|\n| `HUB_KEY` | stdio 模式连接密钥，所有 Agent 接入必须提供，用于身份认证与消息完整性校验 |\n| 4 级权限模型 | authenticated → member → group_manager → full，逐级授权 |\n| CORS 白名单 | 默认拒绝跨域，通过 `CORS_LIST` 显式配置允许的来源 |\n\n## 环境变量\n\n| 变量 | 默认值 | 说明 |\n|------|--------|------|\n| `HUB_KEY` | — | stdio 模式连接密钥（必填） |\n| `DB_PATH` | .\u002Fcomm_hub.db | SQLite 数据库路径 |\n| `LOG_LEVEL` | info | 日志级别：debug \u002F info \u002F warn \u002F error |\n| `CORS_LIST` | (空) | CORS 白名单（逗号分隔），空=拒绝所有跨域 |\n\n## 技术依赖\n\n**Hub 服务器**：\n- Node.js 18+\n- @modelcontextprotocol\u002Fsdk ^1.10.2（支持 StdioServerTransport）\n- express ^4.19\n- better-sqlite3 ^11.9\n- zod ^3.23\n\n**Python 客户端（零外部依赖）**：\n- Python 3.9+（纯标准库：http.client \u002F json \u002F asyncio）\n","# Agent Communication Hub\n\n> 多智能体消息转发与上下文共享中间件 — **v2.4.5**\n\n让两个或多个独立 AI 智能体之间实现**实时双向通信**和**上下文自动同步**。基于 MCP 协议 + stdio 模式，消息本地持久化，延迟 \u003C 50ms。\n\n## 架构概览\n\n```\n┌──────────────┐         ┌──────────────────────────────┐         ┌──────────────┐\n│   Agent A    │  SSE    │   Agent Communication Hub    │  SSE    │   Agent B    │\n│  (Hermes)    │◄───────►│  (stdio)                    │◄───────►│ (WorkBuddy)  │\n│              │  MCP    │                              │  MCP    │              │\n└──────────────┘◄───────►│  SQLite WAL + 30 表          │◄───────►└──────────────┘\n                          │  53 MCP 工具 + 4 级权限     │\n                          │  上下文暂存 + 建议闭环       │\n                          └──────────────┬──────────────┘\n                                         │\n                                    SQLite (WAL)\n```\n\n**三层协议**：\n\n| 层 | 协议 | 用途 | 延迟 |\n|----|------|------|------|\n| MCP 工具层 | stdio JSON-RPC | 结构化操作（发消息、分配任务、查状态） | \u003C50ms |\n| SSE 推送层 | Server-Sent Events | 实时事件通知（新消息、新任务、建议确认） | \u003C50ms |\n\n## 快速上手 (5 分钟)\n\n从零到完成第一次 Agent 间通信的编号流程：\n\n### Step 1: 确认 Hub 运行状态\n\n确认 Agent Communication Hub 服务器正在运行。如果通过 stdio 模式接入，检查 MCP 配置是否正确加载：\n\n```\n调用: get_online_agents()\n期望: 返回在线 Agent 列表（至少含自己）\n失败: Hub 未运行 → 先启动 Hub 服务器\n```\n\n**[检查点] 用户确认**：如果 Hub 未运行，询问用户是否要启动 Hub 服务器。\n\n### Step 2: 注册或确认身份\n\n检查自己是否已在 Hub 注册，如果没有则注册：\n\n```\n1. 调用: query_agents(status='all') → 查看所有 Agent\n2. 如果自己的 Agent ID 不在列表中\n   → register_agent(invite_code, name, capabilities)\n3. 如果已注册 → 记下自己的 agent_id 供后续使用\n```\n\n**[检查点] 用户确认**：注册新 Agent 需要 invite_code，先问用户是否有可用的邀请码。\n\n### Step 3: 维持在线状态\n\n启动心跳维持在线，确保能接收实时消息推送：\n\n```\n调用: heartbeat(agent_id='你的ID')\n频率: 每 30 秒一次（超过 90 秒无心跳则自动标记为离线）\n```\n\n### Step 4: 检查未读消息\n\n上线后第一时间检查是否有离线期间缓存的消息：\n\n```\n1. 调用: search_messages(query='你的ID', limit=20)\n2. 筛选 status='unread' 的消息\n3. 按时间顺序处理，先 acknowledge_message 确认收到，再回复\n```\n\n**[检查点] 用户确认**：找到未读消息后，逐条向用户摘要汇报，请用户确认如何处理。\n\n### Step 5: 发送第一条消息\n\n向另一个 Agent 发送消息，验证双向通信：\n\n```\n调用: send_message(from='你的ID', to='目标AgentID', content='通信链路确认畅通')\n检查返回: delivered_realtime — true=对方在线, false=对方离线\n```\n\n**[检查点] 用户确认**：发送前向用户确认消息内容和目标 Agent。broadcast_message 必须逐条确认。\n\n### 完整闭环示例\n\n```\n场景：Hub 在线 → 检查 WorkBuddy 是否有未读消息 → 处理并回复\n\n1. get_online_agents()                    # 确认自己和对方在线\n2. search_messages(limit=10)              # 查最近消息\n3. acknowledge_message(msg_id, agent_id)  # 标记已读\n4. send_message(to='workbuddy', content='已收到，正在处理')  # 回复\n5. mark_consumed(resource=msg_id, action='replied')  # 消费水位线\n```\n\n## 核心能力\n\n### 53 个 MCP 工具（v2.4.0）\n\n#### Identity 身份 (6)\n\n| 工具 | 功能 |\n|------|------|\n| `register_agent` | 注册新 Agent，需提供 HUB_KEY 认证 |\n| `heartbeat` | Agent 心跳上报，维持在线状态，每 3 次连续心跳记录 +1 |\n| `query_agents` | 查询 Agent 列表，支持状态\u002F角色筛选 |\n| `get_online_agents` | 获取当前在线 Agent 列表 |\n\n#### Message 消息 (5)\n\n| 工具 | 功能 |\n|------|------|\n| `send_message` | Agent 间点对点消息，支持 Markdown，自动去重（sha256） |\n| `broadcast_message` | (需逐条确认后发送) |\n| `acknowledge_message` | 确认已读消息，防止重复出现 |\n| `search_messages` | 全文搜索消息历史 |\n| `batch_acknowledge_messages` | 批量确认消息（1-500 条\u002F次），用于清理消息积压 |\n\n#### File 文件 (3)\n\n| 工具 | 功能 |\n|------|------|\n| `send_file` | 发送文件附件（Base64，10MB 限制），关联到消息 |\n| `receive_file` | 接收附件，返回 Base64 编码内容 |\n| `list_attachments` | 列出附件，支持按消息\u002FAgent 筛选 |\n\n#### Task 任务 (3)\n\n| 工具 | 功能 |\n|------|------|\n| `assign_task` | 创建并分配任务，支持上下文传递 |\n| `update_task_status` | 更新任务状态（inbox→assigned→in_progress→completed\u002Ffailed） |\n| `get_task_status` | 查询任务详情，含依赖、Pipeline、交接信息 |\n\n#### Context 上下文暂存 (5)\n\n| 工具 | 功能 |\n|------|------|\n| `store_memory` | 临时暂存当前任务参考信息 |\n| `recall_memory` | 检索已暂存的上下文 |\n| `list_memories` | 列出当前 Agent 的暂存条目 |\n| `delete_memory` | 删除暂存条目（仅 creator） |\n| `search_memories` | 检索当前 Agent 的暂存内容 |\n\n#### 经验记录\n\n经验记录和策略管理需特定权限配置。\n\n#### 任务协同\n\n| 工具 | 功能 |\n|------|------|\n| `add_dependency` | 添加任务依赖关系（依赖检查） |\n| `remove_dependency` | 删除任务依赖关系 |\n| `get_task_dependencies` | 查询任务上下游依赖 |\n| `create_parallel_group` | 创建并行任务组（2-10 个任务） |\n| `request_handoff` | 请求任务交接 |\n| `accept_handoff` | 接受任务交接 |\n| `reject_handoff` | 拒绝任务交接（含理由） |\n| `add_quality_gate` | 在 Pipeline 中添加质量门 |\n| `evaluate_quality_gate` | 评估质量门（passed\u002Ffailed） |\n| `recalculate_trust_scores` | 按调度执行分数维护 |\n| `create_pipeline` | 创建 Pipeline 流水线 |\n| `get_pipeline` | 查询 Pipeline 详情 |\n| `list_pipelines` | 列出 Pipeline |\n| `add_task_to_pipeline` | 向 Pipeline 添加任务 |\n\n#### 运维工具 (4)\n\n| 工具 | 功能 |\n|------|------|\n| `get_db_stats` | 数据库统计信息（表行数、大小、Agent 数等） |\n| `archive_data` | 数据维护工具 |\n| （其余 2 个内部工具） | 权限验证与控制 |\n| （其余 2 个内部工具） | 权限验证与控制 |\n\n#### 消费水位线 (2)\n\n| 工具 | 功能 |\n|------|------|\n| `mark_consumed` | 标记任务\u002F消息为已消费，防止重复处理 |\n| `check_consumed` | 查询资源是否已被消费 |\n\n> 所有工具内置 try-catch + 3 次指数退避重试（100ms → 200ms → 400ms）。v2.4.0 统一错误格式：`HubError` 错误码 + `mcpError()`\u002F`mcpFail()` 标准返回。`check_consumed` 查询失败时降级返回 `consumed=false`（不阻塞业务）。\n\n### 任务状态机\n\n```\ninbox → assigned → [waiting] → in_progress → completed \u002F failed \u002F cancelled\n```\n\n## 用户确认检查点\n\n以下操作必须在执行前暂停，向用户摘要说明并等待确认：\n\n| # | 操作 | 检查点说明 | 风险 |\n|---|------|-----------|------|\n| 1 | **broadcast_message** | 广播消息会发送给多个 Agent，逐条确认内容和接收列表 | 高 |\n| 2 | **assign_task** | 分配任务前确认：描述是否清晰、目标 Agent 是否合适、Priority 正确 | 中 |\n| 3 | **batch_acknowledge_messages** | 批量确认会一次性标记多条消息为已处理，确认不会遗漏重要信息 | 中 |\n| 4 | **create_pipeline** | 创建流水线前确认任务顺序、质量门设置、参与 Agent | 中 |\n| 5 | **add_quality_gate** | 质量门失败会阻塞后续任务，确认评估标准合理 | 高 |\n| 6 | **request_handoff** | 交接任务前确认目标 Agent 有能力接手、理由充分 | 中 |\n| 7 | **archive_data** | 归档操作会移动数据到归档表，确认归档范围和天数 | 高 |\n| 8 | **store_memory(scope='group')** | 写入组内共享记忆前确认内容适当，不会泄露敏感信息 | 中 |\n| 9 | **propose_strategy** | 提议策略前确认内容准确、分类正确、有实际价值 | 低 |\n| 10 | **reject_handoff** | 拒绝交接需提供理由，确认不会导致任务阻塞 | 中 |\n\n> **规则**：LLM 遇到上表操作时，先向用户输出摘要说明，明确询问\"是否继续？\"，得到肯定答复后再执行。用户可随时跳过检查点。\n\n## 数据隔离与安全边界\n\n| 边界 | 实现方式 |\n|------|---------|\n| **接收方校验** | `send_message`\u002F`assign_task` 中的 `to_agent` 必须为已注册 Agent，未注册 Agent 被拒绝 |\n| **Per-Agent 数据隔离** | 每个 Agent 仅可见自身消息、任务和暂存条目；跨 Agent 查询受 4 级权限控制 |\n| **暂存内容保护** | `store_memory` 创建的条目仅 creator 可检索和删除，不会自动暴露给其他 Agent |\n| **经验记录审批** | `share_experience` 提交的记录需经 `full` 权限确认后才对其他 Agent 可见 |\n\n## 接入配置（stdio 模式）\n\n在 MCP 配置文件中添加 Hub 为 stdio 服务器，提供 `HUB_KEY` 环境变量进行认证。Hub 通过 stdio 传输 MCP 协议，Agent 的 LLM 可直接调用 Hub 工具。\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-comm-hub\": {\n      \"command\": \"node\",\n      \"args\": [\"\u003Chub-install-path>\u002Fstdio.js\"],\n      \"env\": {\n        \"HUB_KEY\": \"your-connection-key\"\n      }\n    }\n  }\n}\n```\n\n## 资源索引\n\n此 skill 目录下已有 Hub 完整源码，可直接参考：\n\n### 本地源文件\n\n| 文件 | 用途 |\n|------|------|\n| `src\u002Fserver.ts` | 服务端入口，Express + MCP\u002FSSE 双通道 |\n| `src\u002Ftools.ts` | 全部 MCP 工具的 TypeScript 实现 |\n| `src\u002Fdb.ts` | SQLite WAL 数据库初始化与连接 |\n| `src\u002Fidentity.ts` | Agent 注册、认证、4 级权限控制 |\n| `src\u002Fdedup.ts` | SHA256 消息去重实现 |\n| `src\u002Ferrors.ts` | HubError 统一错误码（v2.4.0+） |\n| `src\u002Fstdio.ts` | Stdio 模式传输层 |\n| `src\u002Fsse.ts` | SSE 推送通道 |\n| `src\u002Forchestrator.ts` | 任务编排、Pipeline、质量门 |\n| `src\u002Fevolution.ts` | Evolution Engine：策略\u002F经验\u002F信任分 |\n| `src\u002Fmemory.ts` | 上下文暂存与管理 |\n| `src\u002Fsecurity.ts` | 安全验证、CORS、Token 管理 |\n| `src\u002Fmetrics.ts` | 统计指标收集 |\n| `src\u002Frepo\u002F` | 数据访问层（repository pattern） |\n| `package.json` | Node.js 依赖与版本定义 |\n\n### 参考链接\n\n- GitHub 仓库: https:\u002F\u002Fgithub.com\u002Fliuboacean\u002Fagent-comm-hub\n- MCP 协议规范: https:\u002F\u002Fspec.modelcontextprotocol.io\n\n## 权限说明（4 级）\n\n| 级别 | 说明 | 可用工具范围 |\n|------|------|----------|\n| **authenticated** | 已认证（HUB_KEY） | register_agent（初始注册） |\n| **member** | 已注册 Agent | 消息 `send_message`\u002F`acknowledge_message` + 任务 `assign_task`\u002F`get_task_status` |\n| **group_manager** | 并行组管理 | 任务协同 + Pipeline 工具（不含暂存\u002F经验） |\n| **full** | 完整权限 | 全部工具（含运维与建议管理） |\n\n> 部分管理类工具仅特定权限可调用，具体以实际角色配置为准。\n\n> 初始分数 50，公式：`base(50) + verified_capabilities*3 + approved_strategies*2 + positive_feedback*1 - negative_feedback*2`，clamp(0,100)。\n\n## v2.4.0 更新要点\n\n| Phase | 内容 | 变更 |\n|-------|------|------|\n| **A** | tools.ts 拆分 | 2687 行 → 8 模块 + 30 行入口 + utils.ts |\n| **B** | 单元测试 | 100 用例，role-control >= 70% \u002F dedup branches>=60, functions>=70 \u002F utils 100% |\n| **C** | CI\u002FCD | GitHub Actions：typecheck + test + coverage 3 Jobs |\n| **D** | 类型健壮 | any 归零 + HubError 统一错误码 + MCP 返回格式标准化 |\n\n## 踩坑经验速查\n\n| # | 场景 | 要点 |\n|---|------|------|\n| 1 | MCP 多 Client | 必须用 Stateless 模式，Stateful 只允许一个 Client |\n| 2 | MCP Accept Header | 必须带 `Accept: application\u002Fjson, text\u002Fevent-stream` |\n| 3 | MCP 响应格式 | SDK 返回 SSE 格式（`data: {...}`），不是纯 JSON |\n| 4 | ESM 兼容 | 不能用 `require()`，用 `import()` 动态导入 |\n| 5 | UTF-8 块读取 | httpx `resp.read(1)` 会截断多字节字符，用 `read(4096)` |\n| 6 | SSE 心跳 | 10 秒间隔，服务端发 `: ping` |\n| 7 | MCP != SSE | MCP 是工具调用通道（Agent→Hub），SSE 是推送通道（Hub→Agent） |\n| 8 | 离线补发 | 消息\u002F任务存 SQLite，上线后 SSE 自动批量推送 |\n| 9 | stdio 模式 | 所有日志走 stderr，stdout 保留给 JSON-RPC |\n| 10 | better-sqlite3 boolean | 绑定参数必须用 1\u002F0，不能用 true\u002Ffalse |\n| 11 | HubError 错误码 | v2.4.0 统一用 mcpError()\u002FmcpFail()，不要手动构造错误响应 |\n\n## 安全配置\n\n| 配置项 | 说明 |\n|--------|------|\n| `HUB_KEY` | stdio 模式连接密钥，所有 Agent 接入必须提供，用于身份认证与消息完整性校验 |\n| 4 级权限模型 | authenticated → member → group_manager → full，逐级授权 |\n| CORS 白名单 | 默认拒绝跨域，通过 `CORS_LIST` 显式配置允许的来源 |\n\n## 环境变量\n\n| 变量 | 默认值 | 说明 |\n|------|--------|------|\n| `HUB_KEY` | — | stdio 模式连接密钥（必填） |\n| `DB_PATH` | .\u002Fcomm_hub.db | SQLite 数据库路径 |\n| `LOG_LEVEL` | info | 日志级别：debug \u002F info \u002F warn \u002F error |\n| `CORS_LIST` | (空) | CORS 白名单（逗号分隔），空=拒绝所有跨域 |\n\n## 技术依赖\n\n**Hub 服务器**：\n- Node.js 18+\n- @modelcontextprotocol\u002Fsdk ^1.10.2（支持 StdioServerTransport）\n- express ^4.19\n- better-sqlite3 ^11.9\n- zod ^3.23\n\n**Python 客户端（零外部依赖）**：\n- Python 3.9+（纯标准库：http.client \u002F json \u002F asyncio）\n",{"env":24,"name":5,"version":28,"category":29,"triggers":30,"description":7},{"HUB_KEY":25},{"secret":26,"required":26,"description":27},true,"stdio mode connection key for agent authentication","2.4.5","autonomous-ai-agents",[31,32,5,33,34,35,36,37,38],"hub","Hub","通信","消息","workbuddy","QClaw","send_message","assign_task","master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fa\u002Fagent-comm-hub",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":26},[50,53,56],{"tool":51,"command":52},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill agent-comm-hub",{"tool":54,"command":55},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill agent-comm-hub",{"tool":57,"command":58},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill agent-comm-hub","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fa\u002Fagent-comm-hub\u002FSKILL.md",[],[62,70,77,84,91,98],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":69},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":69},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":69},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":69},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":69},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":69},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]