mcpField
A
agent-to-agent

agent-to-agent

github.com/onewave-aiAgent 工作流393248 次安装1 周前更新
代码仓库

关于 agent-to-agent

此技能通过结构化消息和共享上下文协调 Claude Code Agent 之间的通信与任务委派。它使用上下文文件跟踪 Agent、交接、进度和结论。

主要功能

  1. 01Agent 注册与能力发现
  2. 02结构化消息协议
  3. 03流水线与扇出模式
  4. 04带确认的正式交接
  5. 05共享进度与任务跟踪
  6. 06超时与失败恢复

适用场景

  1. 01在多个 Agent 间委派研究与写作
  2. 02协调代码实现和审查
  3. 03跟踪多 Agent 任务交接
  4. 04处理停滞或被拒绝的任务

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/onewave-ai/claude-skills --skill agent-to-agent

安装后在 Claude Code 中输入/agent-to-agent确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
error-handling.md
handoff.md
operations.md
patterns.md
protocol.md
registry.md
workflows.md

详细介绍

Agent-to-Agent（A2A）通信协议

担任 A2A 协调器：作为协议层，让多个 Claude Code Agent 通过结构化消息传递、共享上下文和正式交接进行沟通、协作和委派工作。所有交互都必须通过共享上下文文件 .a2a-context.json 和 Agent 工具进行编排。

目录

  • references/protocol.md — 消息格式、消息类型、生命周期、共享上下文架构、原子化读取-修改-写入、上下文大小管理。
  • references/registry.md — Agent 注册、能力发现、内置 Agent 模板。
  • references/patterns.md — 请求/响应、流水线、扇出/扇入、对话、主管模式。
  • references/handoff.md — 结构化交接、接受、拒绝、链路跟踪。
  • references/error-handling.md — 超时、拒绝、死锁检测、降级、升级矩阵。
  • references/workflows.md — 示例（研究+写作、编码+审查、销售+技术）。
  • references/operations.md — 协调命令、最佳实践、监控、安全、初始化详情。

工作流

  1. 理解目标。确定用户希望通过多个 Agent 完成什么。
  2. 设计团队。决定需要哪些 Agent；从 references/registry.md 中选择模板，或编写自定义规范。
  3. 选择模式。从 references/patterns.md 中选择流水线、扇出/扇入、对话或主管模式。顺序很重要时优先使用流水线，子任务相互独立时使用扇出。
  4. 初始化。定位项目根目录。如果 .a2a-context.json 已存在，则读取并报告当前状态；否则，根据 references/operations.md 中的模板创建该文件。按照 references/registry.md 的要求，将每个 Agent 注册到 agents 部分。
  5. 执行。按照选定的模式，通过 Agent 工具分派 Agent。每个 Agent 的提示词都应包含身份、上下文、任务、输出位置、协议和约束（参见 references/operations.md）。如需并行处理，在单次响应中发出多个 Agent 工具调用。
  6. 协调交接。Agent 转交任务时，要求提供完整的交接内容并发送 ACK，同时追加到任务的 chain 中。遵循 references/handoff.md。
  7. 监控并恢复。读取 .a2a-context.json 以跟踪进度。遇到超时、拒绝、死锁或故障时，按照 references/error-handling.md 中的流程和升级矩阵处理。重试最多 3 次，之后升级给用户。
  8. 交付。将所有 Agent 的发现合并到 conclusions 部分，并呈现最终输出。

核心规则

  • 将 .a2a-context.json 视为唯一事实来源。操作前先读取；修改后写回完整文件。遵循 references/protocol.md 中的原子化读取-修改-写入流程。
  • 所有 Agent 间消息都必须符合 references/protocol.md 中的架构。
  • 每个 Agent 只能写入自己的部分和共享的 conclusions。只有协调器可以更改任务分配。
  • 切勿将机密写入 .a2a-context.json；通过 Agent 提示词在内存中传递敏感数据，并将该文件添加到 .gitignore。
  • 所有故障都必须发送明确的 ERROR 消息；不得静默失败。文件超过 50KB 时运行上下文摘要。

最简示例：双 Agent 流水线

User: "Research the top 5 AI frameworks and write a comparison article."

Coordinator:
1. Create .a2a-context.json
2. Register: researcher, writer
3. Dispatch researcher: "Search for top 5 AI frameworks, compare features, performance, ecosystem"
4. Read researcher's findings from shared context
5. Dispatch writer: "Using the research findings, write a 1200-word comparison article"
6. Read writer's draft from shared context
7. Present the final article to the user

评论

支持 Markdown