convez.ai
AgenteAutomaçãoAvançado
hanxing-AI

Dual-Core AI Collaboration

hanxing-AI/dual-core-collaboration

Orquestração de dois agentes de IA com divisão de responsabilidades

Ver no GitHub
InicialPluginScore · de 0 a 100

Protocolo de colaboração entre dois agentes de IA (Hermes Agent e Claude Code) através de sistema de arquivos compartilhado. Implementa divisão de papéis onde Hermes funciona como orquestrador e distribuidor de tarefas, enquanto Claude Code executa análises profundas, escrita e raciocínio complexo, comunicando-se de forma assíncrona via JSON.

Instalação

$npx convez-ai hanxing-AI/dual-core-collaboration

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de fluxos de trabalho complexos que requerem múltiplos passos e agentes
  • Análise profunda e escrita estratégica delegada enquanto Hermes gerencia contexto e interações
  • Prototipagem rápida de sistemas multi-agentes sem dependências externas (apenas arquivos)

Veredito

Solução técnica bem estruturada para colaboração entre agentes via protocolos de arquivo. Requer conhecimento sólido de CLI, JSON e gerenciamento de processos; útil para quem quer escalar capacidades de IA sem cloud, mas com overhead operacional de sincronização manual e resolução de race conditions.

README

A tradução para o português deste README ainda está na fila.

Dual-Core AI Collaboration

通过共享文件系统实现 Hermes Agent 和 Claude Code 的深度协作。

为什么需要双核?

单个 AI Agent 有上下文长度限制、能力边界、视角单一等问题。双核协作让两个 AI 各司其职:

Agent角色擅长
Hermes Agent枢纽、日常调度信息整合、任务分发、用户交互、工具调用
Claude Code深度分析、执行长文写作、战略咨询、代码生成、深度推理

两者通过共享文件系统通信,异步协作,零依赖。

架构概览

┌─────────────────────────────────────────────────────┐
│                    用户(唯一主帅)                    │
└─────────────────────────────────────────────────────┘
                         │
         ┌───────────────┴───────────────┐
         ▼                               ▼
┌─────────────────┐             ┌─────────────────┐
│  Hermes Agent   │             │  Claude Code    │
│  (WSL/Linux)    │             │  (Windows CLI)  │
└────────┬────────┘             └────────┬────────┘
         │                               │
         └───────────┬───────────────────┘
                     ▼
         ┌─────────────────────┐
         │   ~/.agents/        │
         │   ├── tasks/        │
         │   ├── results/      │
         │   ├── context/      │
         │   └── report/       │
         └─────────────────────┘

快速开始

1. 创建共享目录

mkdir -p ~/.agents/{tasks,results,context,report}

2. 写任务 JSON

cat > ~/.agents/tasks/t-20260616-001.json << 'EOF'
{
  "task_id": "t-20260616-001",
  "from": "hermes",
  "to": "claude",
  "action": "deep_reason",
  "payload": {
    "title": "测试任务",
    "task": "请分析'双核协作'这个概念的优缺点,输出300字分析。",
    "acceptance_criteria": ["覆盖优缺点", "有具体例子"]
  },
  "priority": "normal",
  "status": "pending",
  "created_at": "2026-06-16T10:00:00+08:00"
}
EOF

3. 触发 Claude 执行

cd ~/.agents && claude -p "你是Claude。Hermes有新的pending任务:tasks/t-20260616-001.json。请读取并执行。"

4. 查看结果

cat ~/.agents/results/t-20260616-001-result.md

从 Hermes 侧自动触发

在 Hermes Agent 的对话中,可以直接调用 claude -p:

# 轻量任务(foreground,timeout=300)
terminal(command='cd ~/.agents && claude -p "任务描述"')

# 重任务(background + notify)
terminal(
    command='cd ~/.agents && claude -p "$(cat /tmp/trigger.md)" > /tmp/response.md 2>&1',
    background=True,
    notify_on_complete=True
)

任务 JSON 格式

字段必填说明
task_id✅格式 t-YYYYMMDD-NNN
from✅发起方(hermes/claude)
to✅接收方
action✅deep_reason / strategic_consulting / code_task / long_writing / message
payload.title✅任务标题
payload.task✅具体描述
payload.context❌背景信息(简短)
payload.context_file❌大文件路径(推荐)
payload.acceptance_criteria❌验收标准
priority❌high / normal / low
status✅pending → claimed → done / failed

常见陷阱

Bash 引用问题

prompt 中有特殊字符时,用临时文件:

echo "prompt内容" > /tmp/trigger.md
claude -p "$(cat /tmp/trigger.md)"

长任务超时

claude -p foreground 模式有 5 分钟超时,重任务必须用 background:

terminal(command='...', background=True, notify_on_complete=True)

写文件授权

Claude 在 -p 模式下可能保守不写文件,需在 prompt 中显式授权:

输出约束:直接写入 results/<task>-result.md 完整版,不要先给摘要等确认。

目录结构

~/.agents/
├── tasks/              # 待执行任务(JSON)
├── results/            # 执行结果(Markdown)
├── context/            # 共享上下文
│   ├── messages.md     # 消息索引
│   └── *-context.md    # 任务上下文
├── report/             # 复盘报告
├── PROTOCOL.md         # 协议原文
└── AGENTS.md           # 行为守则

License

MIT

Ver o original no GitHub

Bom para

Relacionados