1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | debug-flow-microsoft-power-platform-skills |
| 作者/维护者 | Microsoft（Power Platform 团队） |
| 来源链接 | https://github.com/microsoft/power-platform-skills/tree/main/plugins/power-automate/skills/debug-flow |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars | 566（GitHub API 获取；此为合集仓库整体数字，不代表本技能自身热度） |
| Forks | 116（GitHub API 获取） |
| 最新版本 | power-automate 插件 v2.1.0（插件 manifest 获取） |
| 安装方式 | Claude Code / GitHub Copilot CLI 会话内执行 /plugin marketplace add microsoft/power-platform-skills 后 /plugin install power-automate@power-platform-skills |
2. 功能介绍与亮点
debug-flow 是 Power Automate 官方插件 power-automate 内的一个交互式调试技能，面向“某个云端流程运行失败，需要定位并修复”这一具体场景，由 FlowAgent MCP 服务器驱动。核心流程：
- 快速分诊：调用
diagnose_run对失败/超时的动作分类，每个问题自带建议修复方案。 - 深度追踪：并行拉取执行轨迹与流程定义；循环体内失败可精确定位到具体迭代。
- 根因分类：内置六类常见故障判定——连接授权失败、表达式求值错误、外部 API/HTTP 错误、必填参数缺失、动作超时、动作类型不匹配，各附具体修复思路。
- 施工与验证闭环：可直接做精确到单个动作/参数的修改，随后重跑验证结果，形成“诊断→修复→验证”对话内闭环，无需切回 Power Automate 门户。
- 输出统一为诊断摘要、失败动作表、根因判定、修复方案四段式结构。
3. 适用场景
固定分类：集成与工作流自动化。适合已在使用 Power Automate 云端流程、遇到某次运行失败（触发器异常、连接器报错、表达式出错等）需要定位根因并动手修复的开发者与业务运维人员；尤其适合不熟悉 Power Automate 门户内错误码含义、希望由 AI 助手直接给出可执行修复方案的中级用户。
4. 跨 Agent 兼容性
- Claude Code：原生支持。仓库 README 明确写明“Claude Code/GitHub Copilot plugins”，安装说明专门给出 Claude Code 会话内的插件市场命令。
- Codex：未验证——已抓取材料未提及。
- OpenClaw：未验证——已抓取材料未提及。
- Hermes Agent：未验证——已抓取材料未提及。
（另注：README 同时列出 GitHub Copilot CLI 支持，但其不属于本报告评估的四个目标生态。）
5. 推荐理由
Power Automate 的错误信息往往是 HTTP 状态码或内部错误名，普通用户很难一眼看出根因。debug-flow 把“看错误猜原因”变成结构化诊断流程：先分诊、再溯源、再按分类给出修复方案，最后直接落地修改并回归验证，整个过程都在对话内完成，省去反复切换门户界面排查的成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Microsoft 出品；所属 power-automate 插件近两周内多次维护提交；GitHub issue 中已有具名用户在缺陷报告的 “Skill / Command” 字段明确标注为 debug-flow（如 #307），证明存在真实使用者 |
| 可用性 | 8 | SKILL.md 文档详尽——工具清单表、分诊步骤、六类根因判定对照表、统一输出格式规范一应俱全；安装为插件市场一条命令；2026-07-22 仍有维护提交，版本已迭代至 2.1.0 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
① 权限范围：本地读写为常规技能工具；核心操作经 FlowAgent MCP 工具执行，可编辑/发布/停用/删除流程与取消运行——权限较广，但均对应“定位并修复失败流程”这一明确用途，无来历不明权限。
② 运行时联网：与 Microsoft 官方 API 通信，外联目标透明，非第三方服务。
③ 凭据处理：复用本机 az login（Azure CLI）会话，凭据由其标准机制管理，技能本身不存储、不转发。
④ 可疑指令：未见混淆代码或隐蔽外发指令。
⑤ 作者信誉：Microsoft 官方仓库出品。
⑥ License：MIT，明确。
⑦ 维护时间：近日（2026-07-22）仍有提交，非弃置项目。
综合：有代码执行但范围明确、可审计；外联目标透明；License 清晰——判 8 分。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 差异化 |
|---|---|---|
| debug-flow（本技能） | 官方 MCP 驱动，交互式定位 + 精确施工修复 + 回归验证全流程闭环 | 开源免费，直接读写用户自己的 Power Automate 环境，无需额外账号或订阅 |
| FlowStudio MCP（第三方商业服务，flowstudio.app） | 面向 Claude、GitHub Copilot、Codex、M365 Copilot 等更广生态的运行历史诊断服务 | 付费产品，个人版 21 天内 100 次免费额度、超出后 Pro 版 $29/月起，闭源 |
| diagnose-flow（同插件姊妹技能） | 已知环境/流程/运行三项 ID 时的全自动深度诊断，无需交互确认 | 免去逐步确认环节，但要求用户预先掌握具体 ID 作为输入前提，适合已锁定目标运行的场景 |
8. 用户评价
用户 LucianoModest0 于 2026-07-24 在 GitHub Issue #307（microsoft/power-platform-skills）中具名报告：使用 debug-flow 排查一次流程运行失败时，定位到 FlowAgent 底层针对 “Default” 类型环境 ID 的主机名派生逻辑存在截断缺陷，并附上详细复现步骤。该报告反映出已有开发者在真实排障场景中使用本技能。除此之外，本技能目前在第三方平台尚无更多具名评价。
9. 其他补充
power-automate 插件是 Microsoft 官方 flow-agent 引擎的市场封装版本，MCP 服务器为自包含单文件打包，无需 npm install 或远程主机，仅依赖本机 Node.js 18+ 与 Azure CLI。
10. 安装使用方式
在 Claude Code 或 GitHub Copilot CLI 会话内依次执行：
/plugin marketplace add microsoft/power-platform-skills
/plugin install power-automate@power-platform-skills首次使用前建议先运行插件自带的 /setup 技能，检测 Node.js、Azure CLI 与 az login 登录状态。日常使用时在对话中直接描述“某个流程运行失败了，帮我看看”，或用 /debug-flow [flow-id] [run-id] 指定具体流程与运行 ID 触发。安装/更新后无需重启 Agent，插件市场支持自动更新。
11. 注意事项
- 需要本机可执行
az login并对目标环境有相应权限，没有已部署 Power Automate 环境无法直接体验。 - 修复类操作会直接改动用户真实环境中的流程，建议先确认方案再执行，重要流程建议先在测试环境验证。
- 该插件底层的环境 ID 解析逻辑此前多次出现过 “Default” 类型环境识别失败的问题（近期已有多轮修复提交），若使用非默认命名的自定义环境，遇到解析类报错可优先怀疑此已知限制。
- 尚无法确认在 Codex / OpenClaw / Hermes Agent 上的兼容情况。