Skip to content

LeoYeAI/agent-master-skills / skills/agent-comm-hub

agent-comm-hub

Flagged

多智能体协同通信基础设施——基于 MCP+SSE 的实时消息、任务调度、记忆共享与进化引擎。支持 WorkBuddy、Hermes、QClaw 及任意 MCP 兼容 Agent 接入。53 个 MCP 工具、4 级权限、零外部依赖 Python SDK。触发词:agent通信、智能体通信、hub通信、多智能体、跨agent通信、任务调度、assign_task、send_message、hermes通信、workbuddy通信、agent hub、通信hub、mcp通信、记忆共享、进化引擎、策略共享、经验分享、共享记忆,共同进化

FileKindSize
.clawhub/origin.jsonconfig146 B
API_REFERENCE.mdmarkdown18.4 KB
HERMES-SETUP.mdmarkdown5.5 KB
README.mdmarkdown8.8 KB
SKILL.mdskill md16.4 KB
_meta.jsonconfig133 B
client-sdk/agent-client.d.tsscript11.6 KB
client-sdk/agent-client.jsscript28.6 KB
client-sdk/agent-client.tsscript29.8 KB
client-sdk/hermes-integration.d.tsscript785 B
client-sdk/hermes-integration.jsscript6.3 KB
client-sdk/hermes-integration.tsscript6.1 KB
client-sdk/hub_client.pyscript50.8 KB
client-sdk/workbuddy-integration.d.tsscript11 B
client-sdk/workbuddy-integration.jsscript4.3 KB
client-sdk/workbuddy-integration.tsscript4.2 KB
deploy/docker-compose.ymlconfig2.0 KB
deploy/grafana/dashboard.jsonconfig16.4 KB
deploy/grafana/provisioning/dashboards/dashboards.ymlconfig258 B
deploy/grafana/provisioning/datasources/prometheus.ymlconfig186 B
deploy/prometheus.ymlconfig408 B
docs/advanced-orchestration-guide.mdmarkdown11.8 KB
docs/evolution-engine-guide.mdmarkdown16.6 KB
docs/hermes-integration-guide.mdmarkdown22.3 KB
package-lock.jsonmanifest139.0 KB
package.jsonmanifest861 B
scripts/hub_task_runner.pyscript6.0 KB
scripts/hub_watcher.pyscript13.9 KB
scripts/install.shscript549 B
scripts/migrate_evolution_db.pyscript6.5 KB
scripts/migrate_from_agent.jsscript2.5 KB
scripts/wb_task_trigger.pyscript2.2 KB
src/db.d.tsscript3.7 KB
src/db.jsscript34.0 KB
src/db.tsscript37.4 KB
src/dedup.d.tsscript2.4 KB
src/dedup.jsscript8.5 KB
src/dedup.tsscript8.7 KB
src/errors.tsscript3.4 KB
src/evolution.d.tsscript6.6 KB
src/evolution.jsscript26.4 KB
src/evolution.tsscript31.0 KB
src/identity.d.tsscript3.4 KB
src/identity.jsscript15.9 KB
src/identity.tsscript17.1 KB
src/logger.d.tsscript1.1 KB
src/logger.jsscript2.8 KB
src/logger.tsscript3.5 KB
src/memory.d.tsscript2.1 KB
src/memory.jsscript13.0 KB
src/memory.tsscript14.3 KB
src/metrics.d.tsscript1.8 KB
src/metrics.jsscript8.4 KB
src/metrics.tsscript9.1 KB
src/orchestrator.d.tsscript6.1 KB
src/orchestrator.jsscript30.4 KB
src/orchestrator.tsscript33.4 KB
src/repo/interfaces.d.tsscript3.6 KB
src/repo/interfaces.jsscript49 B
src/repo/interfaces.tsscript4.2 KB
src/repo/sqlite-impl.d.tsscript225 B
src/repo/sqlite-impl.jsscript7.7 KB
src/repo/sqlite-impl.tsscript8.8 KB
src/repo/types.d.tsscript1021 B
src/repo/types.jsscript116 B
src/repo/types.tsscript1.6 KB
src/security.d.tsscript3.7 KB
src/security.jsscript15.0 KB
src/security.tsscript16.4 KB
src/server.d.tsscript11 B
src/server.jsscript24.7 KB
src/server.tsscript24.7 KB
src/sse.d.tsscript1.6 KB
src/sse.jsscript3.3 KB
src/sse.tsscript3.6 KB
src/stdio.d.tsscript11 B
src/stdio.jsscript1.7 KB
src/stdio.tsscript1.6 KB
src/tokenizer.d.tsscript1.3 KB
src/tokenizer.jsscript3.4 KB
src/tokenizer.tsscript3.2 KB
src/tools.d.tsscript474 B
src/tools.jsscript1.1 KB
src/tools.tsscript1.3 KB
src/tools/consumed.d.tsscript361 B
src/tools/consumed.jsscript5.5 KB
src/tools/consumed.tsscript5.3 KB
src/tools/evolution.d.tsscript660 B
src/tools/evolution.jsscript19.3 KB
src/tools/evolution.tsscript17.6 KB
src/tools/file.d.tsscript348 B
src/tools/file.jsscript7.1 KB
src/tools/file.tsscript6.5 KB
src/tools/identity.d.tsscript438 B
src/tools/identity.jsscript9.8 KB
src/tools/identity.tsscript9.3 KB
src/tools/memory.d.tsscript410 B
src/tools/memory.jsscript11.9 KB
src/tools/memory.tsscript10.8 KB
src/tools/message.d.tsscript467 B
src/tools/message.jsscript17.2 KB
src/tools/message.tsscript15.8 KB
src/tools/orchestrator.d.tsscript746 B
src/tools/orchestrator.jsscript27.8 KB
src/tools/orchestrator.tsscript24.3 KB
src/tools/security.d.tsscript386 B
src/tools/security.jsscript9.0 KB
src/tools/security.tsscript7.8 KB
src/types.tsscript5.9 KB
src/utils.d.tsscript421 B
src/utils.jsscript1.3 KB
src/utils.tsscript3.0 KB
tsconfig.jsonconfig337 B
vitest.config.tsscript1.2 KB

scripts/hub_task_runner.py

View on GitHub
#!/usr/bin/env python3
"""
hub_task_runner.py — Hub 任务即时执行器

监听 ~/.workbuddy/hub-tasks/ 目录,检测到新触发文件后:
1. 弹系统通知提醒用户
2. 通过 osascript 激活 WorkBuddy 窗口(如果 WorkBuddy 正在运行)

用法:
  python3 hub_task_runner.py          # 前台运行(调试)
  launchd 管理(生产环境)

日志:
  /tmp/hub-task-runner.log
  /tmp/hub-task-runner.err
"""

from __future__ import annotations

import json
import logging
import os
import signal
import subprocess
import sys
import time
from pathlib import Path
from typing import Optional

# ─── 配置 ──────────────────────────────────────────────────────────

TRIGGER_DIR = Path(os.getenv(
    "WB_TRIGGER_DIR",
    str(Path.home() / ".workbuddy" / "hub-tasks"),
))

HUB_URL = os.getenv("HUB_URL", "http://localhost:3100")

# 轮询间隔(秒)
POLL_INTERVAL = 5

# ─── 日志 ──────────────────────────────────────────────────────────

logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s [%(levelname)s] %(message)s",
    datefmt="%H:%M:%S",
    handlers=[
        logging.StreamHandler(sys.stderr),
    ],
)
logger = logging.getLogger("hub_task_runner")

# ─── 通知 ──────────────────────────────────────────────────────────

def send_notification(title: str, message: str) -> None:
    """发送 macOS 系统通知"""
    try:
        script = f'display notification "{message}" with title "{title}" sound name "Glass"'
        subprocess.run(
            ["osascript", "-e", script],
            timeout=5,
            capture_output=True,
        )
    except Exception as e:
        logger.warning(f"通知发送失败: {e}")


def activate_workbuddy() -> None:
    """激活 WorkBuddy 窗口(如果正在运行)"""
    try:
        # 检查 WorkBuddy 是否在运行
        result = subprocess.run(
            ["pgrep", "-f", "WorkBuddy.app"],
            capture_output=True,
            timeout=5,
        )
        if result.returncode == 0:
            subprocess.run(
                ["osascript", "-e", 'activate application "WorkBuddy"'],
                timeout=5,
                capture_output=True,
            )
            logger.info("已激活 WorkBuddy 窗口")
    except Exception:
        pass


def update_hub_task(task_id: str, status: str, result: str = "", progress: int = 100) -> bool:
    """更新 Hub 任务状态"""
    try:
        from urllib.request import Request, urlopen
        body = json.dumps({"status": status, "result": result, "progress": progress}).encode()
        req = Request(
            f"{HUB_URL}/api/tasks/{task_id}/status",
            data=body,
            method="PATCH",
        )
        req.add_header("Content-Type", "application/json")
        with urlopen(req, timeout=10) as resp:
            return resp.status < 400
    except Exception as e:
        logger.error(f"更新任务状态失败: {e}")
        return False


# ─── 触发文件处理 ──────────────────────────────────────────────────

def process_trigger(trigger_file: Path) -> None:
    """处理单个触发文件"""
    try:
        data = json.loads(trigger_file.read_text(encoding="utf-8"))
    except (json.JSONDecodeError, OSError) as e:
        logger.error(f"读取触发文件失败 {trigger_file.name}: {e}")
        trigger_file.unlink(missing_ok=True)
        return

    task_id = data.get("task_id", "?")
    description = data.get("description", "")
    assigned_by = data.get("assigned_by", "")

    logger.info(f"[任务] {task_id[:20]} | {assigned_by} | {description[:60]}")

    # 发送系统通知
    send_notification(
        "📬 Hermes → WorkBuddy 任务",
        f"{description[:80]}"
    )

    # 激活 WorkBuddy 窗口
    activate_workbuddy()

    # 不删除触发文件——留给 WorkBuddy 自动化消费
    # 自动化执行后会删除


def check_triggers() -> int:
    """检查并处理所有未消费的触发文件"""
    if not TRIGGER_DIR.exists():
        return 0

    triggers = sorted(TRIGGER_DIR.glob("task_*.json"), key=os.path.getmtime)
    count = 0
    for tf in triggers:
        # 检查是否已经通知过(通过 .notified 后缀标记)
        notified_marker = tf.with_suffix(tf.suffix + ".notified")
        if notified_marker.exists():
            continue

        process_trigger(tf)

        # 标记已通知(不删除原文件,留给自动化消费)
        try:
            notified_marker.touch()
        except OSError:
            pass

        count += 1

    return count


# ─── 主循环 ────────────────────────────────────────────────────────

def main() -> None:
    logger.info("=" * 50)
    logger.info("Hub Task Runner 启动")
    logger.info(f"  触发目录: {TRIGGER_DIR}")
    logger.info(f"  轮询间隔: {POLL_INTERVAL}s")
    logger.info("=" * 50)

    TRIGGER_DIR.mkdir(parents=True, exist_ok=True)

    _running = True

    def signal_handler(signum, frame):
        logger.info("收到退出信号")
        nonlocal _running
        _running = False

    signal.signal(signal.SIGINT, signal_handler)
    signal.signal(signal.SIGTERM, signal_handler)

    while _running:
        try:
            count = check_triggers()
            if count > 0:
                logger.info(f"已通知 {count} 个新任务")
        except Exception as e:
            logger.error(f"检查触发文件出错: {e}")

        time.sleep(POLL_INTERVAL)

    logger.info("Hub Task Runner 已停止")


if __name__ == "__main__":
    main()
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall