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

diagnose-flow — скилл для Claude Code: диагностика Power Automate

Скилл diagnose-flow для Claude Code анализирует упавший запуск 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

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

Скилл запрашивает историю запуска через MCP-инструменты FlowAgent (diagnose_run, get_run_details, get_run_actions), определение потока (get_flow), а для упавших циклов — детали итераций (get_run_action_repetitions). Строит граф зависимостей действий по полю runAfter, разделяет корневые сбои и каскадные пропуски. Сопоставляет ошибки с шаблонами: проблемы авторизации, ошибки выражений, таймауты, неверные параметры, несоответствие типа действия. Если причина в определении, применяет правку через edit_flow или update_flow.

Требует MCP-сервер FlowAgent и учётную запись Power Platform. Без них скилл предложит запустить скилл setup из того же репозитория. Опирается на модель opus и работает в отдельном контексте (context: fork), чтобы не захламлять основную сессию диагностическими данными.

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

  • найти, на каком шаге Power Automate упал поток
  • понять, почему действие в цикле провалилось на третьей итерации
  • исправить определение потока после сбоя подключения
  • разобрать цепочку зависимостей действий и увидеть, где оборвалась ветка

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

  • Разбери, почему упал запуск abc123 потока def456 в окружении env789
  • Проанализируй падение потока: окружение prod-env, поток email-sender, запуск run-20231215
  • Найди причину ошибки в запуске failed-run-001 и предложи, как поправить определение

Как установить diagnose-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 diagnose-flow -a claude-code

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

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

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

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

Вопросы о diagnose-flow

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

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

Что делает diagnose-flow?

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

Что нужно для работы diagnose-flow?

MCP-сервер FlowAgent и учётная запись Power Platform с доступом к окружению. Без MCP скилл попросит запустить скилл setup для настройки.

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

SKILL.md · MIT
---
name: diagnose-flow
description: Deep autonomous diagnosis of a failed flow run. Provide environment, flow, and run IDs. Use when the user asks to diagnose or deeply investigate a specific failed flow run.
user-invocable: true
argument-hint: "<env-id> <flow-id> <run-id>"
context: fork
allowed-tools: Bash, Read, Write, Glob, Grep, 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
---

# Deep Flow Diagnostic Agent

You are an autonomous diagnostic agent. Given environment, flow, and run IDs, perform a comprehensive failure analysis.

## Input

Parse `$ARGUMENTS` for: environment ID, flow ID, run ID.

## Tools

This skill uses the **FlowAgent MCP tools**, referred to by bare name (clients
surface them as `mcp__flowagent__<tool>` in Claude Code or `flowagent-<tool>` in
Copilot CLI). If no MCP tools are present, the plugin is not wired up — run the `setup` skill.

## Workflow

1. **Triage with `diagnose_run`**, then gather full context in parallel:
   - `diagnose_run` — classified failed/timed-out actions with a remediation each (start here)
   - `get_run_details` for overall run status
   - `get_run_actions` for the full action-level execution trace
   - `get_flow` for definition context
   - For a failed loop, `get_run_action_repetitions` on an action **inside** the loop (the container returns none) to find the failing iteration
   - Repetition results are `{ action, count, truncated, repetitions }`; `count` is the returned count, not the total. Treat `truncated: true` as incomplete evidence.
   - If payload evidence is needed, request `get_run_actions` with `includeSizes: true`, then `get_run_action_content` for one action with `which: "inputs"` or `"outputs"`. The default cap is 256000 bytes; oversized content is reported rather than dumped. Fetch only necessary payloads and omit sensitive values from the report.

2. **Build execution graph**: Map each action's `runAfter` dependencies. Identify parallel branches.

3. **Identify failed actions**: Filter for status != Succeeded. Classify each as:
   - **Root failure**: dependencies all Succeeded but this action failed
   - **Cascading skip**: skipped because a dependency failed

4. **Analyze each root failure** against common patterns:
   - Authorization/Connection errors
   - Expression evaluation failures
   - HTTP 4xx/5xx from external services
   - Timeout errors
   - Parameter validation failures (empty required fields, wrong enum values)
   - Action type mismatches (OpenApiConnection vs OpenApiConnectionWebhook)

5. **Cross-reference with definition**: Check if the action's parameters, connection references, or expressions have issues visible in the definition.

6. **Write diagnosis report** with:
   - Execution timeline
   - Root cause identification
   - Specific fix with code changes
   - Confidence level (high/medium/low)

7. **Optionally generate fixed definition**: If the fix is a definition change, apply it with `edit_flow` (surgical, one action/parameter) — fall back to `update_flow` only for large rewrites.

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

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

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
automation-flow-generate forcedotcom Скилл automation-flow-generate создаёт Salesforce Flow и возвращает XML метаданных. Запускайте его, когда нужно описать автоматизацию на экранах, по событию записи или по расписанию. CX Codex +1 6 600установок Power Automate MCP Server by Flow Studio ninihen1 Power Automate MCP Server by Flow Studio — MCP-сервер для Claude Code и Codex, показывающий входы и выходы действий и итерации циклов для диагностики падений потоков. CX Codex +1 ★ 34звёзд репо diagnose getagentseal Скилл diagnose для Claude Code помогает основателю понять, что сломалось, и выбрать один фреймворк вместо перебора наугад. CX Codex +1 811установок diagnose-fix-loop LegendApp Скилл diagnose-fix-loop ведёт агента по кругу: диагноз, точечная правка, проверка тем же сигналом и снова диагноз. Пока не найдётся причина, а не симптом. CX Codex +1 426установок flow-next-deps Gordon Mickel Скилл flow-next-deps для Claude Code показывает граф зависимостей спеков, порядок выполнения и цепочки блокировок. Помогает определить, что заблокировано и в каком порядке запускать спеки. CX Codex +1 ★ 730звёзд репо alibabacloud-elasticsearch-instance-diagnose aliyun Скилл alibabacloud-elasticsearch-instance-diagnose для анализа здоровья кластера Elasticsearch на Alibaba Cloud. Собирает данные из OpenAPI и REST API, выявляет корневые причины проблем и предлагает пути решения. CX Codex +1 127установок

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

Весь набор →
canvas-create-layout Субагент canvas-create-layout для Claude Code проектирует структуру экранов Canvas-приложения до выбора контролов. Он подключается к задаче создания или пересмотра экранов. CX Codex ★ 1 167звёзд репо add-data-source Скилл add-data-source проводит через добавление источника данных или коннектора в Canvas App: сам агент этого не умеет, поэтому он ведёт вас в Power Apps Studio, а потом проверяет результат. CX Codex +1 ★ 1 167звёзд репо list-connections Скилл list-connections находит или создаёт подключения Power Platform для мобильных приложений на Expo и React Native. Пригодится при настройке источников данных через CLI. CX Codex +1 ★ 1 167звёзд репо create-flow Скилл create-flow пошагово помогает создать новый поток Power Automate: собирает требования, проверяет подключённые коннекторы и валидирует определение до создания. CX Codex +1 ★ 1 167звёзд репо add-connector Скилл add-connector подключает любые коннекторы Power Platform к кодовым приложениям Power Apps, если для них нет отдельного специализированного скилла. CX Codex +1 ★ 1 167звёзд репо add-dataverse Скилл add-dataverse подключает таблицы Dataverse к приложению Power Apps и создаёт TypeScript-модели и сервисы. Он также помогает спроектировать и создать новые таблицы. CX Codex +1 ★ 1 167звёзд репо add-office365 Скилл add-office365 подключает Office 365 Outlook к Power Apps code app. Даёт доступ к календарю, отправке писем, чтению inbox и управлению событиями. CX Codex +1 ★ 1 167звёзд репо manage-flows Скилл manage-flows управляет жизненным циклом потоков Power Automate в Claude Code: публикует, тестирует, собирает инвентаризацию и гасит зависшие запуски. CX Codex +1 ★ 1 167звёзд репо

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

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