swarm-issue — субагент для Claude Code: что делает и как установить
Субагент swarm-issue превращает GitHub issue в задачу для роя агентов: дробит работу на подзадачи, назначает исполнителей и ведёт прогресс прямо в issue.
лицензия не указана ★ 850 обновлён 2026-10-26
.claude/agents/swarm-issue.mdЧто делает swarm-issue
Субагент читает issue целиком: заголовок, тело, метки, комментарии. Потом раскладывает работу на подзадачи с приоритетами и раздаёт их агентам. Прогресс возвращается в саму issue — чек-листом в теле и комментарием со статусом, а метки меняются по ходу дела.
Работу обрамляют хуки. Перед стартом агент поднимает координацию и складывает метаданные issue в память роя, после завершения пишет отчёт и заводит follow-up задачи. Инструменты у него почти все из MCP: методы mcp__github__get_issue, mcp__github__create_issue_comment, mcp__claude-flow__swarm_init, mcp__claude-flow__task_orchestrate и другие, плюс Bash, Grep, Read, Write, TodoWrite, TodoRead. Примеры в описании опираются на CLI npx ruv-swarm и gh.
Подключение MCP-серверов github и claude-flow здесь обязательно: без них соответствующие инструменты просто не появятся, и агент встанет на первом же вызове.
Какие задачи решает
- разложить крупную issue на подзадачи с приоритетами
- назначить исполнителей по меткам и тексту задачи
- держать чек-лист в теле issue в актуальном состоянии
- связать дочерние задачи с родительской issue
- собрать отчёт о прогрессе роя одним комментарием
Примеры запросов агенту
- Разбери issue #456: разложи её на подзадачи и назначь агентов.
- Запусти рой по задаче из issue #456 и отмечай прогресс чек-листом в теле.
- Посмотри, что по issue #456 ещё висит, и обнови метки.
Как установить swarm-issue
Вручную: положить файлы
.claude/agents/swarm-issue.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/swarm-issue.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/swarm-issue.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о swarm-issue
Как установить swarm-issue в Claude Code?
Положите файл агента по пути .claude/agents/swarm-issue.md. После этого Claude видит его как субагента.
Что делает swarm-issue?
Берёт GitHub issue, дробит её на подзадачи, назначает исполнителей и отслеживает прогресс, обновляя тело issue и комментарии.
Какие MCP-серверы нужны для работы?
github и claude-flow. Через первый агент читает и правит issue, через второй инициализирует рой, спавнит агентов и оркеструет задачи.