# debugging-mwaa-workflow

Скилл debugging-mwaa-workflow находит причину падения воркфлоу в Amazon MWAA (Provisioned и Serverless). Читает логи CloudWatch, вызывает REST API через aws mwaa invoke-rest-api, собирает контекст и даёт команды для починки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1700 установок · ★ 3536 у репозитория
- Автор: aws
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/aws/agent-toolkit-for-aws/tree/HEAD/plugins/aws-data-analytics/skills/debugging-mwaa-workflow/SKILL.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/debugging-mwaa-workflow

## Что делает

Скилл разбирает упавшие DAG-раны и таски в обеих средах MWAA. Для Provisioned опрашивает `/dags/{id}/dagRuns` и `/taskInstances` через `invoke-rest-api`, читает лог-группы Scheduler, Worker и DAGProcessing. Для Serverless использует `aws mwaa-serverless get-workflow-run` и `get-task-instance`, затем тянет логи из CloudWatch. Классифицирует ошибки на инфраструктурные (OOM, IAM), дрифт зависимостей (`requirements.txt` сломался) и код-данные (плохой SQL, отсутствие файла). Без FFmpeg в `PATH` команды обрезки логов не работают — это известное ограничение AWS CLI.

Различает установку через AWS MCP (`retrieve_skill`) и локальную (`~/.claude/skills/`): в первом случае справочники `references/failure-catalog.md` вытаскиваются тулом, во втором — читаются с диска. Для каждой ошибки даёт одностроковую причину, зону поражения и команды для отката, но сами мутирующие операции (`clear`, `rerun`, `start-workflow-run`) не выполняет — только предлагает.

## Требования
- Работает с: AWS

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill debugging-mwaa-workflow -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/debugging-mwaa-workflow/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/debugging-mwaa-workflow/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill debugging-mwaa-workflow -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/debugging-mwaa-workflow/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill debugging-mwaa-workflow -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/debugging-mwaa-workflow/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aws/agent-toolkit-for-aws plugins/aws-data-analytics/skills/debugging-mwaa-workflow
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/debugging-mwaa-workflow/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill debugging-mwaa-workflow -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aws/agent-toolkit-for-aws --path plugins/aws-data-analytics/skills/debugging-mwaa-workflow
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/debugging-mwaa-workflow/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill debugging-mwaa-workflow -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aws/agent-toolkit-for-aws/tree/HEAD/plugins/aws-data-analytics/skills/debugging-mwaa-workflow/SKILL.md

## Когда брать
- найти, почему DAG упал и не появляется в UI
- разобрать SIGKILL воркера как признак OOM
- отличить ошибку парсинга YAML от падения таски
- проверить, какая зависимость из `requirements.txt` сломала импорт
- прочитать `ErrorMessage` в `GetWorkflowRun` и понять, это код или конфиг

## Примеры запросов агенту
- Почему упал DAG `data_pipeline` в окружении `prod-mwaa`?
- Разбери ошибку в serverless-воркфлоу `arn:aws:mwaa-serverless:us-east-1:123456789012:workflow/etl`
- Таска `extract_orders` свалилась с `ModuleNotFoundError` — что случилось?

## Похожие
- [dt-obs-aws](https://affpapa.org/nevibecode/skills/dt-obs-aws.md) — скилл · 2800 установок
- [aws-cost-operations](https://affpapa.org/nevibecode/skills/aws-cost-operations.md) — скилл · 921 установка
- [hf-cloud-sagemaker-production-defaults](https://affpapa.org/nevibecode/skills/hf-cloud-sagemaker-production-defaults.md) — скилл · 690 установок
- [aws-ecs-fargate](https://affpapa.org/nevibecode/skills/aws-ecs-fargate.md) — скилл · 385 установок
- [aws-cloudtrail](https://affpapa.org/nevibecode/skills/aws-cloudtrail.md) — скилл · 376 установок
- [cloud-expense-management](https://affpapa.org/nevibecode/skills/cloud-expense-management.md) — скилл · 134 установки

Из того же набора: [aws/agent-toolkit-for-aws](https://affpapa.org/nevibecode/by/aws/agent-toolkit-for-aws.md) — 159 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
