# Что такое agents

← [Раздел](README.md) · [Главная](../README.md)

## Цель

Понять, как устроены **специализированные агенты** в экосистеме Cursor + ECC и как их запускать.

## Предварительно

- [AI-ассистент и агент](../01-vvedenie-v-ai/ai-assistent-i-agent.md)
- [05 — Skills](../05-skills/README.md)

## Время

**55–75 минут**

---

## Определение

**Agent (в смысле ECC / Cursor Task)** — конфигурация с:

- **системным промптом** (роль, ограничения);
- **набором tools** (read, write, shell, …);
- **опциональной моделью**;
- **флагами** readonly, background.

Родительский Agent mode Cursor может **делегировать** задачу субагенту через **Task tool** (или UI выбора subagent type).

---

## Где лежат определения

| Источник | Типичный путь |
|----------|---------------|
| ECC | `~/.claude/agents/*.md` после install |
| Cursor subagent types | Встроенные: `explore`, `shell`, `code-reviewer`, … |
| Custom | По документации harness |

ECC agents — markdown с инструкциями; Cursor мапит `subagent_type` на роль.

---

## Примеры ролей ECC

### planner

- Разбивает фичу на фазы.
- Выявляет зависимости и риски.
- **Не пишет код** (или минимально) — output план.

### code-reviewer

- Фокус: correctness, security, maintainability.
- MUST BE USED после изменений кода (по ECC common-agents rule).
- Severity: CRITICAL / HIGH / MEDIUM.

### security-reviewer

- Секреты, injection, authz, OWASP.
- Перед commit на sensitive paths.

### build-error-resolver

- Минимальные правки для green build.
- Без архитектурного рефакторинга.

### explore

- Readonly обход codebase.
- Быстрый поиск файлов и паттернов.

---

## Task tool (концепция)

Родительский агент вызывает:

```
Task(subagent_type="code-reviewer", prompt="Review branch changes...")
```

Субагент работает в **отдельном контексте**, возвращает summary родителю. Это решает **context problem** — не тащить 50 файлов в один чат.

---

## Readonly agents

`explore`, `bugbot` (review), `security-review` — часто **readonly: true**:

- не пишут файлы;
- безопаснее для audit и исследования;
- быстрее одобрение permissions.

---

## Background agents

Долгие задачи (E2E, большой refactor scan) можно `run_in_background: true`:

- родитель не блокируется;
- уведомление по завершении;
- удобно в Multitask Mode Cursor.

---

## Agents vs skills — ещё раз

| Agent | Skill |
|-------|-------|
| Отдельный процесс / контекст | Инструкция в текущей сессии |
| Специализация роли | Специализация процесса |
| `code-reviewer` на diff | `tdd-workflow` при coding |

Часто **комбинация**: skill в dev-сессии → agent reviewer в конце.

---

## common-agents rule (ECC)

Project rule `common-agents.mdc` рекомендует:

- planner — complex features;
- code-reviewer — after code changes;
- tdd-guide — new features / bugs;
- build-error-resolver — when build fails.

Это **оркестрация по умолчанию** для команд, использующих ECC.

---

## Практика

1. В Agent mode попросите: «Use code-reviewer subagent on uncommitted changes» (или эквивалент UI).
2. Сравните ответ с обычным «поревьюй код» без subagent.
3. Запустите `explore` с prompt «найди все HTTP handlers в проекте» (readonly).

---

## Ограничения

- Субагент **не видит** всю историю родителя — передавайте суть в `prompt`.
- Не запускайте 10 субагентов без необходимости — cost и merge complexity.
- CRITICAL findings от reviewer — исправляйте до merge.

---

## Самопроверка

1. Что передаётся субагенту при Task?
2. Зачем readonly для explore?
3. Какой agent после failed `npm run build`?
4. Чем agent planner отличается от Plan mode?

## Дальше

→ [Субагенты и оркестрация](subagenty-i-orkestraciya.md)