swarm-agent

Category: Tools & Productivity | Uploader: BrianIS8090 | Downloads: 0 | Version: v1.0（Latest）
Инструкция для Claude-агента по работе в системе SWARM. Используй при регистрации в SWARM, получении задач, блокировке файлов и завершении работы.
Changelog: Source: GitHub https://github.com/BrianIS8090/SWARM
Directory Structure

Current level: .claude/skills/swarm-agent/
📄 SKILL.md 6.6 KB
SKILL.md

---
name: swarm-agent
description: Инструкция для Claude-агента по работе в системе SWARM. Используй при регистрации в SWARM, получении задач, блокировке файлов и завершении работы.
---

# SWARM — Инструкция для Claude-агента

## Обзор

Ты — Claude-агент в системе SWARM. SWARM координирует работу нескольких LLM-агентов над общей кодовой базой. Лидер (человек) создаёт задачи, а ты выполняешь их по очереди.

## Регистрация

### Исключение для автозапуска оркестратором

Если оркестратор явно передал тебе имя и роль и написал, что они уже подтверждены пользователем, **не запрашивай их повторно**.
В этом случае сразу используй переданные значения в `swarm join`.

### ⛔ ОБЯЗАТЕЛЬНО СПРОСИ У ПОЛЬЗОВАТЕЛЯ:

**Перед регистрацией ты ОБЯЗАН спросить у пользователя:**
1. **Какое имя использовать?** (например: "claude1", "bot-alex", "worker3")
2. **Какая роль?** (architect / developer / tester / devops)

**НЕ ПРИДУМЫВАЙ ИМЯ И РОЛЬ САМОСТОЯТЕЛЬНО!** Жди ответа пользователя.

### После получения ответа:

```bash
swarm join --cli claude --name <имя-от-пользователя> --role <роль-от-пользователя>
```

**Роли:** `architect`, `developer`, `tester`, `devops`
**Имя:** только латиница, цифры, дефис, подчёркивание (1-32 символа). Например: `dev-1`, `claude_worker`, `tester3`.

### После регистрации: ЗАПОМНИ СВОЁ ИМЯ!

Ты будешь использовать его во ВСЕХ последующих командах через `--agent`.

## Цикл работы

После команды Лидера "начинай работать" выполняй цикл:

```
1. swarm next --agent <твоё-имя>              → получить задачу
2. Проанализировать                            → определить файлы для изменения
3. swarm lock <файл> --agent <твоё-имя>       → заблокировать один файл
4. Внести правки только в этот файл            → написать код
5. swarm unlock --file <файл> --agent <твоё-имя> → сразу разблокировать файл
6. Если нужен другой файл — вернуться к шагу 3
7. Во время долгого анализа вызывать heartbeat → swarm heartbeat --agent <твоё-имя> --quiet
8. swarm done --summary "..." --agent <твоё-имя> → завершить с резюме
9. Повторить с шага 1
```

## Команды

**ВАЖНО:** Всегда добавляй `--agent <твоё-имя>` к командам!
**ВАЖНО:** Не используй `swarm --help`, `swarm task --help` и другие варианты `--help`. Агенту разрешены только команды, перечисленные в этом скилле.

| Команда | Описание |
|---------|----------|
| `swarm join --cli claude --name X --role Y` | Зарегистрироваться |
| `swarm next --agent X` | Получить задачу |
| `swarm lock файл --agent X` | Заблокировать один файл |
| `swarm unlock --file файл --agent X` | Снять свою блокировку с файла |
| `swarm heartbeat --agent X --quiet` | Обновить heartbeat без лишнего вывода |
| `swarm done --summary "..." --agent X` | Завершить задачу |
| `swarm status --agent X` | Проверить свой статус |

## Правила блокировки

- **ВСЕГДА** блокируй файлы перед редактированием
- Блокировать можно **только один файл за раз**
- Максимум **одна активная блокировка на агента** в любой момент
- Блокируй файл **только в момент редактирования**
- Как только правки в файле закончены — **сразу** выполни `swarm unlock --file <файл> --agent <твоё-имя>`
- Если тот же файл нужен снова — заново заблокируй его, внеси правки и снова разблокируй
- Если файл занят — жди. **Не** снимай чужую блокировку и **не** проси систему сделать это за тебя
- Свою обычную блокировку снимает только агент-владелец; принудительно снять её может только Лидер или оркестратор

## Heartbeat

- `swarm agents` может показывать старый heartbeat даже у живого агента, если тот долго анализирует код или редактирует локально и не вызывает команды SWARM
- Во время долгого анализа, ожидания ответа пользователя или длинной правки периодически вызывай `swarm heartbeat --agent <твоё-имя> --quiet`
- Старый heartbeat сам по себе **не означает**, что другой агент завис

## Формат резюме

```bash
swarm done --summary "Добавлен UserController с CRUD, файлы: user.py, models.py" --agent <твоё-имя>
```

Кратко: что сделано + какие файлы изменены.

## Важно

- Нет задач → остановись и жди
- Не спрашивай "что дальше?" — просто жди
- Не редактируй файлы без блокировки
- Не используй `swarm unlock --force`
- Не используй `swarm task add`, `swarm task assign`, `swarm task close`, `swarm task reset`
- Не переназначай задачи, не меняй очередь и не выполняй функции оркестратора
- Не модифицируй swarm.db напрямую
Comments 0
Latest | Hot
Please login before commenting.
No comments yet. Be the first one!
swarm-agent

Directory Structure

SKILL.md

Report

Notice
