К основному содержанию
скилл CX Codex

debug-flow — скилл для Claude Code: что делает и как установить

Скилл debug-flow разбирает ошибки в запусках Power Automate. Находит сбойные действия, выявляет причину по цепочке зависимостей и помогает внести точечный фикс.

MIT ★ 1 167 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add microsoft/power-platform-skills
/plugin install power-automate@power-platform-skills
Открыть на GitHub

Что делает debug-flow

Скилл подключается к Power Automate через набор инструментов FlowAgent MCP. При вызове агент запрашивает историю выполнений, отбирает последний неудачный запуск и группирует ошибки через инструмент diagnose_run. Если у потока вообще нет запусков в истории, скилл прямо сообщит об этом и предложит проверить триггер, а не станет угадывать проблему по схеме.

Внутри скилл анализирует граф зависимостей runAfter, чтобы отделить первопричину от каскадных сбоев в цепочке. Он разбирает ошибки авторизации подключений, синтаксис формул, ответы внешних API и таймауты. При анализе циклов скилл обращается к конкретному действию внутри цикла через get_run_action_repetitions, чтобы указать номер сбойной итерации.

Для работы требуется настроенный MCP-сервер FlowAgent, иначе команды диагностики недоступны. Исправления в схему потока агент предлагает вносить точечно через edit_flow, не перезаписывая всё определение целиком.

Какие задачи решает

  • Найти упавшее действие в сложном запуске Power Automate
  • Определить сбойную итерацию внутри цикла действий
  • Отделить первопричину сбоя от каскадно пропущенных шагов
  • Исправить упавшее выражение или параметр без перезаписи всего потока

Примеры запросов агенту

  • Помоги разобрать последний упавший запуск потока с ID 12345-abc
  • Найди, почему упал flow "Send Daily Report", и покажи ошибку
  • Проверь выполнение flow-id 5a6b7c с run-id 987654 и предложи исправление

Как установить debug-flow

1Через маркетплейс плагинов

/plugin marketplace add microsoft/power-platform-skills
/plugin install power-automate@power-platform-skills

Команда ставит плагин power-automate целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add microsoft/power-platform-skills --skill debug-flow -a claude-code

3Вручную: положить файлы

~/.claude/skills/debug-flow/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/debug-flow/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о debug-flow

Как установить debug-flow в Claude Code?

Сначала добавьте каталог репозитория командой /plugin marketplace add microsoft/power-platform-skills, затем выполните установку плагина /plugin install power-automate@power-platform-skills.

Что делает скилл debug-flow?

Он читает историю запусков потока Power Automate, находит сбойные действия, анализирует контекст ошибки и предлагает точечное исправление логики или формул.

Что произойдёт, если у потока ещё не было запусков?

Скилл не станет выдумывать сбой: он сразу сообщит об отсутствии записей в истории и предложит проверить настройки триггера либо запустить тестовый прогон.

Исходный текст

SKILL.md · MIT
---
name: debug-flow
description: Debug a failed Power Automate flow run. Use when a flow failed, has errors, or the user wants to troubleshoot a run. If the flow has no runs, says so plainly instead of guessing a cause.
user-invocable: true
argument-hint: "[flow-id] [run-id]"
allowed-tools: Bash, Read, Write, Glob, Grep, AskUserQuestion, mcp__flowagent__list_environments, mcp__flowagent__set_current_env, mcp__flowagent__get_current_env, mcp__flowagent__resolve_environment, mcp__flowagent__list_flows, mcp__flowagent__get_flow, mcp__flowagent__create_flow, mcp__flowagent__update_flow, mcp__flowagent__edit_flow, mcp__flowagent__copy_flow, mcp__flowagent__publish_flow, mcp__flowagent__disable_flow, mcp__flowagent__delete_flow, mcp__flowagent__run_flow, mcp__flowagent__get_run_history, mcp__flowagent__get_run_details, mcp__flowagent__get_run_actions, mcp__flowagent__get_run_action_content, mcp__flowagent__get_run_action_repetitions, mcp__flowagent__cancel_run, mcp__flowagent__cancel_all_runs, mcp__flowagent__resubmit_run, mcp__flowagent__diagnose_run, mcp__flowagent__list_connections, mcp__flowagent__list_connectors, mcp__flowagent__get_connector, mcp__flowagent__search_operations, mcp__flowagent__get_operation_details, mcp__flowagent__pick_or_create_connection, mcp__flowagent__resolve_refs, mcp__flowagent__resolve_params, mcp__flowagent__scaffold_flow, mcp__flowagent__list_templates, mcp__flowagent__validate_flow, mcp__flowagent__preflight_flow, mcp__flowagent__smoke_test, mcp__flowagent__get_expression_help, mcp__flowagent__list_desktop_flows, mcp__flowagent__list_machine_groups, mcp__flowagent__run_desktop_flow, mcp__flowagent__get_flow_context, mcp__flowagent__set_current_flow, mcp__flowagent__clear_current_flow, mcp__flowagent__invoke_operation, mcp__flowagent__get_past_trigger_inputs, mcp__flowagent__test_connection, mcp__flowagent__fix_connection, mcp__flowagent__delete_connection, mcp__flowagent__preview_update, mcp__flowagent__get_backup, mcp__flowagent__list_backups, mcp__flowagent__restore_backup, mcp__flowagent__list_trigger_emulators, mcp__flowagent__resolve_entity, mcp__flowagent__list_datasets, mcp__flowagent__list_tables, mcp__flowagent__whoami, mcp__flowagent__doctor, mcp__flowagent__reconnect, mcp__flowagent__list_accounts, mcp__flowagent__switch_account
model: opus
---

# Debug a Failed Flow Run

You are helping the user debug a failed Power Automate flow run.

## Tools

This skill uses the **FlowAgent MCP tools**. Clients surface them with a
client-specific prefix — `mcp__flowagent__<tool>` (Claude Code) or
`flowagent-<tool>` (Copilot CLI) — so they're referred to by bare name below
(e.g. `get_run_actions`). Use CLI shell commands (local engine build only) for
CLI-only operations or when no MCP tools are present.

| Tool | Purpose |
|------|---------|
| `list_flows` | Find flows by name (use `name` param for search) |
| `get_run_history` | Get recent runs for a flow |
| `diagnose_run` | One-shot: classify failed actions with remediations |
| `get_run_details` | Get details for a specific run |
| `get_run_actions` | Get action-level execution trace |
| `get_run_action_content` | Retrieve bounded recorded inputs or outputs for one action |
| `get_run_action_repetitions` | Iteration-level detail for a loop (which iteration failed — pass an action **inside** the loop) |
| `get_flow` | Get flow definition for context |
| `get_operation_details` | Confirm the correct action type / parameters |
| `edit_flow` | Apply a surgical fix to one action/parameter |
| `update_flow` | Replace the whole definition (large rewrites) |
| `run_flow` | Re-run after fix (use `wait: true` to see result) |
| `resubmit_run` / `cancel_run` | Resubmit a fixed run / cancel a stuck one |

## Steps

1. **Identify the flow and run**
   - Parse `$ARGUMENTS` for flow ID and optional run ID.
   - If the user names an environment (or none is set), call `resolve_environment` first so the search runs in the right environment.
   - If no flow ID, call `list_flows` with `name` param to search. Ask user to pick if ambiguous.
   - If no run ID, call `get_run_history` and find the most recent failed run.
   - **If `get_run_history` returns no runs, stop and say so plainly** ("this flow has no recorded runs in its history"). Do not invent a failure, do not diagnose from the definition as if it had failed; offer to check the trigger configuration or to run/test the flow instead.
   - Present recent runs in a table: Run ID | Status | Start Time | Error

2. **Fast triage with `diagnose_run`**
   - Call `diagnose_run` for the run — it returns the failed/timed-out actions already classified with a remediation each. Use this as the starting point.
   - For deeper analysis, also fetch (in parallel): `get_run_actions` (full trace) and `get_flow` (definition context). For a failed loop, call `get_run_action_repetitions` on an action **inside** the loop to find the failing iteration.
   - Repetition results are `{ action, count, truncated, repetitions }`; `count` is the returned count, not the total. If `truncated` is true, do not infer absence from the returned subset.
   - When recorded payloads are needed, use `get_run_actions` with `includeSizes: true`, then `get_run_action_content` with the action name and `which: "inputs"` or `"outputs"`. The default download cap is 256000 bytes; an oversized result is reported rather than dumped. Retrieve only what the diagnosis needs and avoid reproducing sensitive payloads in the report.

3. **Analyze failures**
   - Identify actions with status != "Succeeded"
   - Trace the `runAfter` dependency chain to separate root cause from cascading failures:
     - **Root cause**: action whose dependencies all Succeeded but it failed
     - **Cascading**: actions skipped because a dependency failed
   - Report root cause actions with: name, type, error code, error message

4. **Root cause classification**
   - **Connection errors** (`AuthorizationFailed`, `ConnectionNotFound`, `InvokerConnectionOverrideFailed`): Suggest re-auth or fix connection source to Embedded
   - **Expression errors** (`ExpressionEvaluationFailed`, `InvalidTemplate`): Show the expression, explain what's wrong, suggest fix
   - **API/External errors** (401/403/404/429/500+): Explain the HTTP error, check connector status
   - **Parameter errors** (`WorkflowOperationParametersRuntimeMissingValue`): Missing/empty required parameter. Add null guard: `@if(empty(...), 'default', ...)`
   - **Timeout** (`ActionTimedOut`): Suggest retry policy or splitting the operation
   - **Type mismatch** (`InvalidOpenApiConnectionOperationType`): Wrong action type. Call `get_operation_details` to find correct type.

5. **Suggest fix**
   - Provide a specific fix with code/expression changes.
   - If the fix is a definition change, offer to apply it with `edit_flow` (surgical, one action/parameter) — fall back to `update_flow` only for large rewrites.

6. **Re-test**
   - Offer to call `run_flow` with `wait: true` to verify the fix works (or `resubmit_run` to retry the original run with its trigger inputs).
   - Report the result: Succeeded/Failed with action details.

## Output Format

### Diagnosis Summary
- **Flow**: [name] ([ID])
- **Run**: [run ID] | [start time] | Status: **[status]**

### Failed Actions
| # | Action | Status | Error Code | Error Message |
|---|--------|--------|------------|---------------|

### Root Cause
[Classification]: [Explanation]

### Fix
[Step-by-step fix with code]

© Microsoft · MIT · microsoft/power-platform-skills

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
Power Automate MCP Server by Flow Studio ninihen1 Power Automate MCP Server by Flow Studio — MCP-сервер для Claude Code и Codex, показывающий входы и выходы действий и итерации циклов для диагностики падений потоков. CX Codex +1 ★ 34звёзд репо flowstudio-power-automate-debug официальный github Скилл flowstudio-power-automate-debug для GitHub Copilot помогает найти причину сбоя облачного потока Power Automate по данным отдельных действий. Разбирает ошибки запусков, когда общего статуса недостаточно. CX Codex +1 1 900установок agents-debug aws-agentcore Скилл agents-debug для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — читает трейсы и логи AgentCore, чтобы найти причину ошибок. CX Codex +1 2 100установок render-debug Render Скилл render-debug разбирает упавшие деплои на Render по логам, метрикам и состоянию базы, находит причину и предлагает правку. CX Codex +1 617установок pulumi-debug-failed-operation pulumi Скилл pulumi-debug-failed-operation читает запись об упавшем pulumi up или pulumi preview, находит причину и подсказывает, где её править. CX Codex +1 405установок crontap-debug-failed-runs Crontap Скилл crontap-debug-failed-runs для Claude Code и Codex. Анализирует неудачные запуски расписаний Crontap по конфигурации и истории выполнения, диагностирует сбои HTTP-задач по ошибкам, таймаутам и сетевым проблемам. CX Codex +1 1 300установок

Из того же набора157

Весь набор →
canvas-create-discovery Субагент canvas-create-discovery для Claude Code проверяет доступные в Power Apps элементы управления, источники данных и API, фиксируя решения и ограничения. Оценивает осуществимость замысла холст-приложения. CX Codex ★ 1 167звёзд репо check-updates Скилл check-updates для Claude Code пошагово проверяет и обновляет прямые зависимости мобильных проектов Power Apps, проверяя сборки и автоматически откатывая изменения при ошибках. CX Codex +1 ★ 1 167звёзд репо report-issue Скилл report-issue для Claude Code собирает контекст проекта и диагностику, чтобы подготовить текст GitHub issue для плагина mobile-app при сбое или запросе к документации. CX Codex +1 ★ 1 167звёзд репо setup Скилл setup ведёт агента через настройку Process Intelligence: проверяет зависимости, выбирает облако и окружение, привязывает сессию az login и активирует профиль. CX Codex +1 ★ 1 167звёзд репо configure-canvas-mcp Скилл configure-canvas-mcp подключает Canvas Authoring MCP к текущей сессии совместной работы в Power Apps. Запустите его перед редактированием canvas-приложения, если сервер ещё не подключён. CX Codex +1 ★ 1 167звёзд репо add-sharepoint Скилл add-sharepoint подключает SharePoint Online к Power Apps code app: читает списки, управляет документами, создаёт новые списки через Graph API. CX Codex +1 ★ 1 167звёзд репо preview-offline-scope Скилл preview-offline-scope оценивает объём загрузки и частоту синхронизации офлайн-профиля Power Platform до отправки пользователям. Работает только в режиме чтения. CX Codex +1 ★ 1 167звёзд репо canvas-screen-builder Субагент canvas-screen-builder для Claude Code добавляет или изменяет один экран в существующем Canvas App по общему контракту и заданию. Он выполняет локальную проверку без компиляции. CX Codex ★ 1 167звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой