Dual-Core AI Collaboration
hanxing-AI/dual-core-collaboration
Orquestração de dois agentes de IA com divisão de responsabilidades
Ver no GitHubProtocolo 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-collaboration1 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
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