diagnose-flow — скилл для Claude Code: диагностика Power Automate
Скилл diagnose-flow для Claude Code анализирует упавший запуск Power Automate: строит граф выполнения, находит причину сбоя и предлагает исправление определения.
MIT ★ 1 167 обновлён 2026-10-29
/plugin marketplace add microsoft/power-platform-skills
/plugin install power-automate@power-platform-skillsЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/diagnose-flow/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/diagnose-flow/
1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill diagnose-flow -a codex2Вручную: положить файлы
.agents/skills/diagnose-flow/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill diagnose-flow -a cursor2Вручную: положить файлы
.cursor/skills/diagnose-flow/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/power-platform-skills plugins/power-automate/skills/diagnose-flow2Вручную: положить файлы
.github/skills/diagnose-flow/SKILL.md1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill diagnose-flow -a gemini-cli2Командой платформы
gemini skills install https://github.com/microsoft/power-platform-skills --path plugins/power-automate/skills/diagnose-flowВручную: положить файлы
.devin/skills/diagnose-flow/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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