agent-to-agent — скилл для Claude Code: что делает и как установить
Скилл agent-to-agent координирует совместную работу нескольких Claude-агентов через общий файл контекста, очереди задач и формальные хэнд-оффы.
MIT 263 установок ★ 440 обновлён 2026-10-20
npx skills add OneWave-AI/claude-skills --skill agent-to-agent -a claude-codeЧто делает agent-to-agent
Скилл разворачивает протокол A2A (Agent-to-Agent) для сценариев, где одной модели тесно. Главный агент берёт роль координатора: формирует команду исполнителей, выбирает топологию взаимодействия (конвейер, fan-out/fan-in или супервизор) и вызывает субагентов через инструмент Agent.
Вся общая память и статусы пишутся в единый файл .a2a-context.json в корне репозитория. Скилл регламентирует атомарное чтение и запись: каждый агент может менять только свою секцию и блок conclusions, а переназначать задачи разрешено лишь координатору. Если размер файла переваливает за 50KB, протокол предписывает суммаризацию контекста.
Файл .a2a-context.json нужно сразу добавить в .gitignore, потому что секреты в него писать запрещено. На восстановление после ошибок, сбоев или таймаутов даётся до 3 повторов, после чего координатор эскалирует проблему человеку.
Какие задачи решает
- связать исследователя и автора в один конвейер подготовки статьи
- организовать параллельный сбор данных несколькими субагентами через fan-out
- передавать контекст и задачи между агентами без потери промежуточных выводов
- автоматически отслеживать цепочки хэнд-оффов и таймауты между агентами
Примеры запросов агенту
- Собери команду из исследователя и технического писателя через протокол A2A для обзора фреймворков
- Запусти параллельный аудит безопасности и код-ревью пуллреквеста по паттерну supervisor
- Инициализируй .a2a-context.json и настрой пайплайн для генерации тестов
Как установить agent-to-agent
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill agent-to-agent -a claude-code2Вручную: положить файлы
~/.claude/skills/agent-to-agent/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/agent-to-agent/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill agent-to-agent -a codex2Вручную: положить файлы
.agents/skills/agent-to-agent/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill agent-to-agent -a cursor2Вручную: положить файлы
.cursor/skills/agent-to-agent/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills agent-to-agent2Вручную: положить файлы
.github/skills/agent-to-agent/SKILL.md1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill agent-to-agent -a gemini-cli2Командой платформы
gemini skills install https://github.com/OneWave-AI/claude-skills --path agent-to-agentВручную: положить файлы
.devin/skills/agent-to-agent/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill agent-to-agent -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об agent-to-agent
Как установить agent-to-agent в Claude Code?
Выполните команду npx skills add OneWave-AI/claude-skills --skill agent-to-agent -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/agent-to-agent/SKILL.md.
Что делает скилл agent-to-agent?
Он задаёт правила оркестрации нескольких агентов, распределяя их роли через шаблоны реестра и сохраняя состояние сессии в структурированном JSON-файле.
Где хранятся сообщения и результаты работы агентов?
Единым источником правды служит файл .a2a-context.json в корне проекта, куда агенты записывают свои результаты по жесткой схеме.
Исходный текст
SKILL.md · MIT
--- name: agent-to-agent description: Agent-to-Agent (A2A) communication protocol. Connect two or more Claude agents that pass messages, share context, delegate tasks, and collaborate. Implements structured handoffs, shared memory, and multi-agent conversations. tools: Read, Write, Agent, Bash, Glob, Grep model: inherit --- # Agent-to-Agent (A2A) Communication Protocol Act as the A2A Coordinator: a protocol layer that lets multiple Claude Code agents communicate, collaborate, and delegate work through structured message passing, shared context, and formal handoffs. Orchestrate every interaction through the shared context file `.a2a-context.json` and the Agent tool. ## Contents - `references/protocol.md` — message format, message types, lifecycle, shared context schema, atomic read-modify-write, context size management. - `references/registry.md` — agent registration, capability discovery, built-in agent templates. - `references/patterns.md` — request/response, pipeline, fan-out/fan-in, conversation, supervisor. - `references/handoff.md` — structured handoff, acceptance, rejection, chain tracking. - `references/error-handling.md` — timeouts, rejections, deadlock detection, degradation, escalation matrix. - `references/workflows.md` — worked examples (research+writer, code+review, sales+technical). - `references/operations.md` — coordination commands, best practices, monitoring, security, init detail. ## Workflow 1. Understand the goal. Determine what the user wants to accomplish with multiple agents. 2. Design the team. Decide which agents are needed; draw from the templates in `references/registry.md` or write custom specs. 3. Choose the pattern. Select pipeline, fan-out/fan-in, conversation, or supervisor from `references/patterns.md`. Prefer pipeline when order matters, fan-out when subtasks are independent. 4. Initialize. Locate the project root. Read `.a2a-context.json` if it exists and report current state; otherwise create it from the template in `references/operations.md`. Register every agent into the `agents` section per `references/registry.md`. 5. Execute. Dispatch agents via the Agent tool following the chosen pattern. Structure each agent prompt with identity, context, task, output location, protocol, and constraints (see `references/operations.md`). For parallelism, issue multiple Agent tool calls in a single response. 6. Coordinate handoffs. When an agent transfers a task, require a full handoff payload and an ACK, and append to the task `chain`. Follow `references/handoff.md`. 7. Monitor and recover. Read `.a2a-context.json` to track progress. On timeout, rejection, deadlock, or failure, apply the procedures and escalation matrix in `references/error-handling.md`. Cap retries at 3 before escalating to the user. 8. Deliver. Merge all agent findings into the `conclusions` section and present the final output. ## Core Rules - Treat `.a2a-context.json` as the single source of truth. Read it before acting; write the complete file back after modifying. Follow the atomic read-modify-write procedure in `references/protocol.md`. - Conform every inter-agent message to the schema in `references/protocol.md`. - Confine each agent to writing its own section plus shared `conclusions`. Restrict task assignment changes to the Coordinator. - Never write secrets to `.a2a-context.json`; pass sensitive data in-memory through Agent prompts and add the file to `.gitignore`. - Require explicit ERROR messages for all failures; never fail silently. Run context summarization when the file exceeds 50KB. ## Minimal Example: 2-Agent Pipeline ``` 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 ```
© OneWave-AI · MIT · OneWave-AI/claude-skills