# Meta Agent Recovery

> Мета-скилл обработки сбоев субагентов: таймауты, зависания, каскадные отказы, fallback. Trigger when: агент упал, агент завис, partial results, таймаут, agent crash, субагент не отвечает, каскадный сбой

- **Type:** Skill
- **Install:** `agentstack add skill-kissrosecicd-hub-agents-evolution-recovery`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kissrosecicd-hub](https://agentstack.voostack.com/s/kissrosecicd-hub)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kissrosecicd-hub](https://github.com/kissrosecicd-hub)
- **Source:** https://github.com/kissrosecicd-hub/agents-evolution/tree/main/.agents/skills/meta/orchestration/recovery

## Install

```sh
agentstack add skill-kissrosecicd-hub-agents-evolution-recovery
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Meta: Agent Recovery

Обрабатывает сбои субагентов — таймауты, зависания, каскадные отказы — и обеспечивает graceful degradation.

## Типы сбоев

| Тип | Симптом | Причина |
|-----|---------|---------|
| **Таймаут** | Агент не отвечает N секунд | Задача слишком сложная, модель зависла |
| **JSON парсинг** | `InvalidParameter`, `function.arguments` | Ответ слишком длинный, спецсимволы |
| **Каскадный** | Агент B без данных от агента A | Агент A упал, B ожидает его результат |
| **Частичный** | Агент ответил но не завершил | Прервался на середине задачи |
| **Полный** | Агент вернул ошибку сразу | Неподдерживаемый subagent_type |

## Стратегии восстановления

### 1. Таймаут → Skip & Continue

```
Агент не отвечает → ждать 30s → skip → продолжить с остальными →
в отчёте: "X agent skipped (timeout), results from Y agents"
```

**Когда:** Агент не критичный для результата.

### 2. Таймаут → Retry

```
Агент не отвечает → ждать 30s → повторить с упрощённым промптом →
если снова таймаут → skip
```

**Когда:** Агент важный, задача не слишком длинная.

### 3. Каскадный → Fallback

```
Агент A упал → агент B не может работать без A →
B тоже skip → main agent делает работу A сам
```

**Когда:** Критичный агент (без него весь pipeline ломается).

### 4. Частичный результат → Использовать

```
Агент начал но не закончил → взять что есть →
в отчёте: "partial result from X agent, may be incomplete"
```

**Когда:** Частичные результаты полезны (нашёл 3 из 5 проблем).

### 5. Полный сбой → Main agent fallback

```
Агент вообще не запускается → main agent берёт его роль →
читает SKILL.md → выполняет задачу сам
```

**Когда:** Агент недоступен, subagent_type не поддерживается.

## Матрица решений

| Агент упал | Критичен? | Действие |
|---|---|---|
| code-reviewer | Да (основной аудит) | Retry → Fallback: main agent делает review |
| security-auditor | Да (безопасность) | Retry → Fallback: main agent проверяет секреты |
| test-architect | Нет (можно потом) | Skip → пометить «тесты написать позже» |
| debugger | Зависит от бага | Если баг критичный → main agent чинит |
| docs-writer | Нет | Skip → «документацию добавить позже» |
| git-doctor | Нет | Skip → пользователь сделает сам |

## Graceful degradation

```
Идеально: 4 агента → полный отчёт
Реально: 2 агента + 2 skipped → отчёт с пометками

Пользователь видит:
✅ Результаты от code-reviewer
✅ Результаты от security-auditor
⏭️ test-architect skipped (timeout)
⏭️ docs-writer skipped (cascade failure)

Вывод: «2 из 4 агентов ответили. Основные проблемы найдены.
Тесты и документация — следующий шаг отдельно.»
```

## Правила

- **Никогда не ждать вечно** — таймаут 30-60s максимум
- **Не терять частичные результаты** — лучше неполный отчёт чем никакой
- **Честно говорить пользователю** — какие агенты не ответили
- **Fallback на main agent** — если критичный агент упал, я делаю сам
- **Не спавнить заново больше 1 раза** — если retry не помог, skip
- **Сохранять контекст** — даже если все агенты упали, результаты разведки (Explore) остаются

## Отчёт о сбоях

```
## Agent Status

| Agent | Status | Details |
|-------|--------|---------|
| code-reviewer | ✅ Completed | 12 findings |
| security-auditor | ✅ Completed | 8 findings |
| test-architect | ⏭️ Skipped | Timeout after 60s |
| docs-writer | ⏭️ Skipped | Cascade (needs test results) |

### Recovery Actions Taken
- test-architect: retried once, still timeout → skipped
- docs-writer: cascade skip, no test context available

### What's Missing
- Test coverage assessment
- Test file generation
→ Main agent can do this separately on request
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kissrosecicd-hub](https://github.com/kissrosecicd-hub)
- **Source:** [kissrosecicd-hub/agents-evolution](https://github.com/kissrosecicd-hub/agents-evolution)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kissrosecicd-hub-agents-evolution-recovery
- Seller: https://agentstack.voostack.com/s/kissrosecicd-hub
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.