maa-pipeline-testing

name	maa-pipeline-testing
description	Test and validate MaaFramework Pipeline JSON, recognition nodes, action nodes, CustomAction/CustomRecognition wiring, resource loading, and end-to-end task behavior. Use when running `run_pipeline`, checking OCR/TemplateMatch/ColorMatch ROI, validating `context.run_task()` results, auditing `action: Custom` or `recognition: Custom` registrations, or choosing the right resource-check command.

Pipeline Testing Skill

官方依据核对

测试命令、schema 字段或 MaaFramework API 行为以原始官方来源为准。涉及版本差异、binding 兼容性或语义变化时，通过 $maa-wiki 定位官方文档、schema 与源码后再下结论；测试通过不能替代对官方契约的核对。

如果用户要求验收一个尚未定义目标状态和完成条件的端到端自动化需求，先交给 $maa-workflow-build 建立任务契约；已有契约时，再用本 skill 为其中的验收条件收集测试证据。

项目初始化接力

测试前先查目标项目根目录的 basic_info.md。存在且包含第 0 节时，读取“0. Maa Skills 接力协议”和第 2/5/7/8/9/10 节，用 task/resource、公共返回节点、OCR/模板/ROI 和风险清单规划测试；随后以当前截图、当前源码和 TaskDetail 为准。优先把公共 Click 节点复制成临时 DoNothing 探针做初始化 smoke test，完成后调用 stop_pipeline 并删除临时文件。文件缺失或没有第 0 节时按本 skill 直接发现测试所需上下文；不得自动调用 $maa-project-init，只有用户明确要求初始化或刷新时才调用。源码更新更晚时视为缓存可能过期并以源码为准，不自动刷新或覆盖。

概述

测试 MaaFramework Pipeline JSON 中的 node，验证识别和操作是否正常工作。

历史审查后的测试边界

• 资源加载检查是 smoke test，不是端到端证明：python tools/ci/check_resource.py assets/resource/base 能证明资源包可加载，但不能证明 CustomAction/CustomRecognition 名称存在、参数路径正确、run_task() 分支判断正确。
• Custom 映射必须单独查：所有 action: Custom / action.type = Custom 的 custom_action 都要能映射到 @AgentServer.custom_action(...)；所有 recognition.type = Custom 的 custom_recognition 都要能映射到 @AgentServer.custom_recognition(...)。
• CustomRecognition 也要测：M9A 证明复杂 OCR/list/image 逻辑经常放在 CustomRecognition，不要只测 CustomAction。