project-board-sync — субагент для Claude Code: доска GitHub Projects
Субагент project-board-sync для Claude Code, Codex и Cursor связывает задачи роя ИИ-агентов с доской GitHub Projects, синхронизируя карточки, статусы и метрики.
лицензия не указана ★ 850 обновлён 2026-10-26
.claude/agents/project-board-sync.mdЧто делает project-board-sync
Субагент заводит карточки из issue, двигает их по колонкам вслед за сменой статуса задачи агента и заполняет поля вроде числа агентов и сложности. С GitHub он говорит через gh, с роем — через MCP-инструменты mcp__claude-flow__*: swarm_init, agent_spawn, task_orchestrate, github_issue_track, workflow_execute.
Поведение описано в .github/board-sync.yml: какой статус задачи в какую колонку идёт, какой тип агента становится меткой, как приоритет ложится в поле проекта. Виды доски задаются отдельно — канбан по статусу, таблица по нагрузке агентов, roadmap по ETA. Массовые правки карточек, шаблоны и перенос между досками идут командами npx ruv-swarm github board-*.
Сначала срабатывают pre-хуки: gh auth status, gh project list --owner @me, git status --porcelain. Если gh не авторизован, первый же хук выходит с ошибкой и работа не начинается. Проверка пользователя идёт через gh api user | jq, поэтому на машине нужен ещё и jq. Инструменты mcp__claude-flow__* доступны только при подключённом MCP-сервере claude-flow.
Какие задачи решает
- завести карточки GitHub Projects из списка issue
- переносить карточки по колонкам вслед за статусом задачи
- собрать burndown и velocity за спринт
- разложить карточки по агентам с учётом текущей загрузки
- держать доски Development и QA в согласованном состоянии
Примеры запросов агенту
- Подключи проект Development Board к рою и включи двустороннюю синхронизацию статусов
- Импортируй открытые issue с меткой enhancement в колонку Backlog и назначь на них агентов
- Покажи burndown и velocity по текущему спринту
Как установить project-board-sync
Вручную: положить файлы
.claude/agents/project-board-sync.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/project-board-sync.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/project-board-sync.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о project-board-sync
Как установить project-board-sync в Claude Code?
Скопируй файл субагента в проект по пути .claude/agents/project-board-sync.md — после этого он доступен в сессии.
Что делает project-board-sync?
Держит доску GitHub Projects в соответствии с состоянием задач роя агентов: создаёт карточки из issue, переносит их между колонками, обновляет поля и собирает метрики спринта.
Что нужно, чтобы субагент заработал?
Авторизованный gh, установленный jq для проверок в хуках, git-репозиторий проекта и подключённый MCP-сервер claude-flow для инструментов mcp__claude-flow__*.