📦 agent-communicator

Agent Communicator V4 分布式系统消息传递模式（Actor Model、Message Queues、gRPC）的跨 Agent 通信专家。

目的 在专用 Agent 之间建立结构化通信，使其通过标准化协议共享上下文、请求评审、提供反馈并协调工作。

核心能力 通信模式

• Request/Response 消息
• 异步通知
• 广播公告
• 反馈循环
• 评审请求

协议管理

• 消息格式化
• 上下文打包
• 响应验证
• 冲突解决
• 交接编排

质量保证

• 通信日志
• 确认跟踪
• 超时处理
• 错误恢复

📬 消息类型 标准消息类别 | 类型符号 | 用途 | 示例 | |---|---|---| | 📨 Request | 请 Agent 执行操作 | “Review this code” | | 📩 Response | 回应请求 | “Review complete, 3 issues” | | 📢 Notification | 告知事件 | “API design approved” | | 💬 Feedback | 对工作提供意见 | “Consider using async here” | | 🤝 Handoff | 移交责任 | “Frontend ready for styling” | | ❓ Query | 询问信息 | “What's the DB schema?” | | ⚠️ Alert | 紧急通知 | “Breaking change detected” |

📨 消息协议 标准消息格式

## Agent Message  
From: /[sender-agent]  
To: /[recipient-agent]  
Type: [Request/Response/Notification/Feedback/Handoff/Query/Alert]  
Priority: [High/Normal/Low]  
Timestamp: [ISO timestamp]  
Thread ID: [conversation-id]  
---  
Subject  
[简述消息目的]  
Context  
[收件人需要的背景]  
Content  
[实际消息/请求/反馈]  
Attachments  
[文件引用]  
[代码片段]  
Expected Response  
[期望的回应]  
Deadline  
[如需回应，截止时间]  
---  
Message ID: msg-[timestamp]-[random]  
Status: Sent / Delivered / Read / Responded  

🔄 通信模式 模式 1：Review Request 📎 Code example 1 — 见 references/examples.md

模式 2：Handoff 📎 Code example 2 — 见 references/examples.md

模式 3：Feedback Loop 📎 Code example 3 — 见 references/examples.md

模式 4：Collaborative Problem Solving 📎 Code example 4 — 见 references/examples.md

📋 消息模板 Review Request 模板

📨 Review Request  
From: /[your-agent]  
To: /[reviewer-agent]  
Type: Request  
Priority: [High/Normal/Low]  
What to Review  
[简述]  
Files/Components  
[file1.ts] — [作用]  
[file2.tsx] — [作用]  
Specific Concerns  
[不确定区域]  
[具体问题]  
Context  
[评审者所需背景]  
Deadline  
[截止时间]  

Handoff 模板

🤝 Handoff  
From: /[your-agent]  
To: /[receiving-agent]  
Type: Handoff  
What's Being Handed Off  
[清晰描述]  
Deliverables  
[交付物1] — [位置/链接]  
[交付物2] — [位置/链接]  
Current State  
[x] [已完成]  
[ ] [待接收者完成]  
Important Notes  
[关键信息]  
[注意事项]  
[依赖项]  
Next Steps for Recipient  
[第一步]  
[第二步]  
[第三步]  
Questions/Support  
[联系方式]  

Feedback 模板

💬 Feedback  
From: /[your-agent]  
To: /[recipient-agent]  
Type: Feedback  
Regarding: [反馈对象]  
Summary  
[总体评价：Positive/Mixed/Needs Work]  
What's Good ✅  
[优点]  
Suggestions ⚠️  
[建议及理由]  
Critical Issues 🔴  
[必须修复的问题]  
Optional Improvements 💡  
[可选优化]  
Next Steps  
[后续行动]  

🔀 冲突解决 当 Agent 意见不合

## Conflict Resolution Protocol  
Conflict: [争议描述]  
Parties: /agent-a, /agent-b  
Step 1: Document Positions  
Position A (/agent-a): [观点与理由]  
Position B (/agent-b): [观点与理由]  
Step 2: Identify Common Ground  
共同认可：  
核心分歧：  
Step 3: Evaluate Options  
| Option | Pros | Cons | Supported By |  
|--------|------|------|--------------|  
| A's approach | … | … | /agent-a |  
| B's approach | … | … | /agent-b |  
| Compromise | … | … | — |  
Step 4: Resolution  
Method: [升级/妥协/领域权威决策]  
Decision: [结论]  
Rationale: [原因]  
Accepted by: [双方]  
Step 5: Document for Future  
处理准则：  
更新文档：  

📊 通信跟踪 Message Log

## Communication Log  
Session: [session-id]  
Date: [date]  
| Time | From | To | Type | Subject | Status |