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/migrate_evolution_db.py

View on GitHub
#!/usr/bin/env python3
"""
evolution.db → comm_hub.db strategies 数据迁移脚本

将 Hermes 旧版 evolution.db 中的 memories 数据迁移到 Hub 的 strategies 表。
经核实(2026-04-24),evolution.db memories 表为空(0 条记录),
本脚本作为未来数据迁移的备用工具。

用法:
    python3 migrate_evolution_db.py [--source /path/to/evolution.db] [--target /path/to/comm_hub.db] [--dry-run]

选项:
    --source   源数据库路径(默认 ~/.workbuddy/memory/evolution.db)
    --target   目标数据库路径(默认 ../comm_hub.db)
    --dry-run  只分析不写入,打印迁移计划
"""

import sqlite3
import hashlib
import sys
import os
import argparse
from datetime import datetime

# ─── 默认路径 ─────────────────────────────────────────────
DEFAULT_SOURCE = os.path.expanduser("~/.workbuddy/memory/evolution.db")
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
DEFAULT_TARGET = os.path.join(SCRIPT_DIR, "..", "comm_hub.db")

# ─── evolution.db memories → strategies 字段映射 ─────────
# memories 表:id, hash, content, category, importance, tags, source, created_at, last_accessed
# strategies 表:id, title, content, category, sensitivity, proposer_id, status, ...

# category 映射
CATEGORY_MAP = {
    "general": "other",
    "workflow": "workflow",
    "fix": "fix",
    "tool_config": "tool_config",
    "prompt_template": "prompt_template",
    "experience": "experience",
    "other": "other",
}

# importance → sensitivity 映射
# evolution.db importance 1-5,5=最高 → sensitivity high/normal
def map_sensitivity(importance: int, content: str) -> str:
    """将 importance 值映射为 sensitivity"""
    if importance >= 4:
        return "high"
    # 高敏感关键词检测(与 Hub 逻辑一致)
    high_patterns = [
        "system_prompt", "系统指令", "capability_declare",
        "能力声明", "permission_change", "权限变更", "role_change",
    ]
    for p in high_patterns:
        if p.lower() in content.lower():
            return "high"
    return "normal"


def generate_title(content: str, max_len: int = 200) -> str:
    """从 content 生成标题(取第一行或前 100 字符)"""
    first_line = content.split("\n")[0].strip()
    if first_line and len(first_line) <= max_len:
        return first_line
    return content[:max_len - 3] + "..."


def migrate(source_path: str, target_path: str, dry_run: bool = False):
    """执行迁移"""
    print(f"=== evolution.db → comm_hub.db 迁移 ===")
    print(f"源: {source_path}")
    print(f"目标: {target_path}")
    print(f"模式: {'DRY RUN' if dry_run else 'LIVE'}")
    print()

    # 检查源文件
    if not os.path.exists(source_path):
        print(f"❌ 源文件不存在: {source_path}")
        return False

    # 连接数据库
    src = sqlite3.connect(source_path)
    tgt = sqlite3.connect(target_path)

    # 读取源数据
    rows = src.execute("SELECT id, hash, content, category, importance, tags, source, created_at FROM memories").fetchall()
    print(f"源 memories 表: {len(rows)} 条记录")

    if not rows:
        print("✅ 无数据需要迁移,退出")
        src.close()
        tgt.close()
        return True

    # 分析可迁移数据
    migrated = 0
    skipped = 0
    errors = 0

    for row in rows:
        mem_id, mem_hash, content, category, importance, tags, source_agent, created_at = row

        # 验证必要字段
        if not content or len(content) < 10:
            print(f"  ⏭️ 跳过 id={mem_id}: 内容过短(<10 字符)")
            skipped += 1
            continue

        if len(content) > 5000:
            print(f"  ⏭️ 跳过 id={mem_id}: 内容过长(>{5000} 字符)")
            skipped += 1
            continue

        # 映射字段
        title = generate_title(content)
        hub_category = CATEGORY_MAP.get(category, "other")
        sensitivity = map_sensitivity(importance, content)
        proposer_id = source_agent if source_agent and source_agent != "manual" else "migration_script"
        tags_json = tags if tags else "[]"

        print(f"  📋 迁移 id={mem_id}: '{title[:50]}...' → category={hub_category}, sensitivity={sensitivity}")

        if not dry_run:
            try:
                tgt.execute("""
                    INSERT INTO strategies (title, content, category, sensitivity, proposer_id, status, proposed_at, task_id, source_trust)
                    VALUES (?, ?, ?, ?, ?, 'approved', ?, ?, 50)
                """, (title, content, hub_category, sensitivity, proposer_id, created_at, tags_json))

                # 获取新 id 并插入 FTS
                new_id = tgt.execute("SELECT last_insert_rowid()").fetchone()[0]
                try:
                    tgt.execute("""
                        INSERT INTO strategies_fts (rowid, title, content, category)
                        VALUES (?, ?, ?, ?)
                    """, (new_id, title, content, hub_category))
                except Exception as fts_err:
                    print(f"    ⚠️ FTS 插入失败: {fts_err}")

                migrated += 1
            except Exception as e:
                print(f"    ❌ 错误: {e}")
                errors += 1

    if not dry_run:
        tgt.commit()

    # 一致性验证
    if not dry_run:
        tgt_total = tgt.execute("SELECT COUNT(*) FROM strategies WHERE proposer_id='migration_script'").fetchone()[0]
        print(f"\n=== 迁移验证 ===")
        print(f"迁移写入: {migrated}")
        print(f"跳过: {skipped}")
        print(f"错误: {errors}")
        print(f"目标表迁移记录: {tgt_total}")
        if tgt_total == migrated:
            print("✅ 一致性验证通过")
        else:
            print("⚠️ 一致性验证不匹配!")
    else:
        print(f"\n=== DRY RUN 摘要 ===")
        print(f"可迁移: {migrated + skipped - errors}")
        print(f"将跳过: {skipped}")

    src.close()
    tgt.close()
    return errors == 0


if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="evolution.db → comm_hub.db 数据迁移")
    parser.add_argument("--source", default=DEFAULT_SOURCE, help="源 evolution.db 路径")
    parser.add_argument("--target", default=DEFAULT_TARGET, help="目标 comm_hub.db 路径")
    parser.add_argument("--dry-run", action="store_true", help="只分析不写入")
    args = parser.parse_args()

    success = migrate(args.source, args.target, args.dry_run)
    sys.exit(0 if success else 1)
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