菜单
调试和优化 MaaFramework Pipeline JSON。用于对照 schema 验证配置，检测缺失引用、循环依赖、孤立节点、命名与行为不匹配、ROI/阈值问题，并给出可靠性、性能和可维护性改进建议。触发词包括 debug pipeline、validate pipeline、optimize pipeline、pipeline error。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
MaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON，设计节点流程，使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作，并检查 MaaFramework 项目的通用 Pipeline 可靠性。
MDA 项目专属开发指南。用于在 MDA 中编写或审查 MaaFramework Pipeline、Project Interface 任务、locale、go-service 组件时补充项目结构、业务域、命名习惯和现有任务选项示例。与通用 pipeline-guide、pipeline-debug、generate-pi-task、go-service-guide 配合使用。
分析 Windows 崩溃转储文件（.dmp），诊断 MaaFramework / MXU 项目及其依赖项的崩溃。用于 issue 日志包或附件中发现 .dmp 文件，或用户要求分析 DMP / 崩溃转储时。
根据 MaaFramework Pipeline 定义生成或更新 Project Interface 任务 JSON。用于创建、编辑或扩展 assets/tasks/ 下的任务文件，将 Pipeline 节点映射为用户可配置选项（switch/select/checkbox/input）并绑定 pipeline_override。
MaaFramework C++ 日志宏用法指南。用于写 C++ MaaFramework 扩展、Custom 组件或工具代码时使用 LogInfo/LogError/LogWarn/LogDebug/LogTrace、VAR、容器输出和自定义类型日志。
分析 MDA 公开 Issue、日志包或本地日志。用于 `https://github.com/1204244136/MDA/issues/...`、`#1234`、MDA 日志压缩包、识别失败、任务卡死、控制器差异、Pipeline/Agent/MXU 问题。会从 maafw.log、maafw.bak.*.log、go-service.log、mxu-tauri.log、mxu-web-*.log、mxu-agent*.log、config/*、on_error/ 中筛选证据，并结合 MDA、MaaFramework、MXU 代码和文档判断根因。
| name | pipeline-debug |
| description | 调试和优化 MaaFramework Pipeline JSON。用于对照 schema 验证配置，检测缺失引用、循环依赖、孤立节点、命名与行为不匹配、ROI/阈值问题，并给出可靠性、性能和可维护性改进建议。触发词包括 debug pipeline、validate pipeline、optimize pipeline、pipeline error。 |
| license | MIT |
| compatibility | Designed for Claude Code |
| allowed-tools | Read Grep Glob |
tools/schema/pipeline.schema.json 及相关 schema 验证 Pipeline JSON。Click 节点没有动作，Visible 节点却执行点击。优先读取当前项目中的 schema：
tools/schema/pipeline.schema.jsontools/schema/interface_import.schema.jsontools/schema/interface.schema.jsontools/schema/custom.recognition.schema.jsontools/schema/custom.action.schema.json如果项目缺少某个 schema，说明缺失项并继续基于 MaaFramework 通用协议分析。
recognition、action、enabled、next、interrupt、sub、on_error、timeout、max_hit。{type, param} 字段。逐节点检查：
使用 Pipeline 节点命名规范 理解节点角色：
<Domain>Main：入口节点。<Domain><Subtask>Flow：流程编排节点。<Domain>Enter<Page>：进入页面或功能。<Domain>On<Page>Page / <Domain><Object>Visible：页面或 UI 状态检测。<Domain>Click<Object> / Select / Claim / Purchase：动作节点。<Domain>Confirm<Object>：确认弹窗或确认操作。<Domain><Page>Entered：进入成功哨兵节点。<Domain>End / EndTask：终止节点。重点检查命名与行为不匹配：
Click<Object> 但没有 action: Click 或等价动作。Visible / On<Page>Page 却执行点击。Flow 节点包含具体识别或动作。Enter<Page> 点击后没有成功哨兵或重试/异常处理。Detected 暴露底层识别实现，而 Visible / Available / Selected 更符合业务语义。next[]、interrupt[]、sub[]、on_error[] 目标都必须存在。max_hit、timeout 或明确终止节点。next 且不像终止节点的死胡同。[JumpBack]、[Anchor] 等节点属性是否用于合适场景。详见 调试规则参考。快速检查：
enabled 默认值与 Project Interface 选项语义不一致。建议按优先级输出：
如发现问题，给出修正后的 JSON 片段，并说明每处改动原因。响应格式见 输出格式。
next 的节点可以是合法终止节点，但必须符合流程语义。enabled 默认为 true，只有显式 false 才默认关闭。interrupt / sub / on_error 的语义依项目使用习惯和 MaaFramework 版本而定，先查 schema 和现有模式。expected 可能支持正则；是否自动 i18n 取决于当前项目工具链。