maa-pipeline-guide
Installation
SKILL.md
Universal Pipeline 编写指南
官方知识核对
本指南中的 Pipeline 约定是工作经验和社区规范,不能替代 pinned 版本的官方协议、schema 或源码。当字段语义、默认值、版本差异或 API 行为存在疑问时,通过 $maa-wiki 定位 MaaLLMWiki catalog 中的原始来源,再以官方文档、tools/pipeline.schema.json 或 MaaFramework 源码为准。
如果用户提出的是尚未定义起始状态、安全边界和验收条件的端到端自动化目标,先交给 $maa-workflow-build 建立任务契约与状态机;已有契约时,再用本 skill 处理 Pipeline 设计、修改或审查。
项目初始化接力
开始广泛扫描仓库前,先在目标项目根目录查找 basic_info.md:
- 存在时先读其中“0. Maa Skills 接力协议”,再优先读第 3/4/5/7/8/9 节,获取主 Pipeline、公共节点、返回/弹窗、OCR、模板与 ROI 约定。
- 它只是
maa-project-init生成的上下文缓存;待修改节点必须回到当前 JSON/Python 核实,设备相关结论必须用当前截图或识别结果核实。 - 文件缺失或没有第 0 节时,按本 skill 正常发现项目结构并说明未使用初始化缓存;不得自动调用
$maa-project-init,只有用户明确要求初始化或刷新时才调用。 - 相关
interface.json、Pipeline 或 Agent 文件晚于basic_info.md时,将缓存视为可能过期并以当前源码为准;不得自动刷新或覆盖已有非空文件。