Agent skill

Pipeline Guide

by 1204244136 in 1204244136/MDA

MaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON,设计节点流程,使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作,并检查 MaaFramework 项目的通用 Pipeline 可靠性。

AGPL-3.0Auto-check passed

Install Pipeline Guide

skills CLI
$ npx skills add 1204244136/MDA --skill pipeline-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install 1204244136/MDA pipeline-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/1204244136/MDA.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/pipeline-guide .claude/skills/pipeline-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pipeline-guide
GitHub stars
120
Token cost
~1.4k tokens
SKILL.md length
202 words
Files
2
Skills in repo
9
Repo updated
First seen
Licence
AGPL-3.0

At a glance

MaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON,设计节点流程,使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作,并检查 MaaFramework 项目的通用 Pipeline 可靠性。

  • Works in 5 steps: 状态驱动:遵循“识别 → 操作 →… → 覆盖可能画面:扩充 next 列表,覆盖操作后可能出现的页面、弹窗、加载态和异常态。 → 少用硬延迟:尽量不用 pre_delay / post_delay /… → …
  • SKILL.md covers 核心原则, 节点命名, Pipeline v2 推荐格式 and 常用识别算法, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Pipeline Guide is an agent skill from 1204244136/MDA. MaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON,设计节点流程,使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作,并检查 MaaFramework 项目的通用 Pipeline 可靠性。

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `field-reference.md`).

The repository describes itself as: Nikke小助手 | Assistant For Goddess of Victory: Nikke. The licence is AGPL-3.0.

Example prompts

  • “/pipeline-guide”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 状态驱动:遵循“识别 → 操作 → 识别”循环。每次操作必须基于识别结果,禁止假设操作后画面状态。
  2. 覆盖可能画面:扩充 next 列表,覆盖操作后可能出现的页面、弹窗、加载态和异常态。
  3. 少用硬延迟:尽量不用 pre_delay / post_delay / timeout 解决稳定性问题,优先通过中间识别节点和 pre_wait_freezes / post_wait_freezes 等待画面稳定。
  4. 720p 基准:坐标、ROI、模板裁剪和截图判断统一以 1280×720 为基准,除非当前项目另有明确约定。
  5. 格式一致:遵循项目现有 JSON 格式化规则;常见 MaaFramework 项目使用 4 空格缩进和数组元素换行。

What it can do on your machine

Read from SKILL.md and the folder at commit 90bb2b2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are jsonc).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pipeline Guide loads about 1.4k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 202 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from 1204244136/MDA at commit 90bb2b2, republished under its AGPL-3.0 licence (© 1204244136). 202 words, ~1,428 tokens.

Download SKILL.mdSave it as .claude/skills/pipeline-guide/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pipeline-guide
description
MaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON,设计节点流程,使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作,并检查 MaaFramework 项目的通用 Pipeline 可靠性。

MaaFramework Pipeline 编写指南

核心原则

  1. 状态驱动:遵循“识别 → 操作 → 识别”循环。每次操作必须基于识别结果,禁止假设操作后画面状态。
  2. 覆盖可能画面:扩充 next 列表,覆盖操作后可能出现的页面、弹窗、加载态和异常态。
  3. 少用硬延迟:尽量不用 pre_delay / post_delay / timeout 解决稳定性问题,优先通过中间识别节点和 pre_wait_freezes / post_wait_freezes 等待画面稳定。
  4. 720p 基准:坐标、ROI、模板裁剪和截图判断统一以 1280×720 为基准,除非当前项目另有明确约定。
  5. 格式一致:遵循项目现有 JSON 格式化规则;常见 MaaFramework 项目使用 4 空格缩进和数组元素换行。

节点命名

  • 节点名使用 PascalCase,推荐基础格式为 <Domain><SemanticPart><Role>。
  • 不要在全项目无脑统一为“动宾”或“宾动”;先判断节点角色,再决定语序。
  • 动作节点使用动宾:命中后会执行点击、选择、领取、购买、确认、关闭等动作时,使用 <Domain><Verb><Object><OptionalRole>,例如 CommonConfirmReward、DailyTaskClaimMissionReward、ShopPurchaseGem、BattleClosePage。
  • 状态 / 对象 / 纯检测节点使用宾 + 状态或角色后缀:例如 ShopGemVisible、BattleStartButtonBlocked、DailyRewardsRewardClaimed;不要为了动宾写成 VisibleGem、BlockedStartButton。
  • 按钮、弹窗、文本模板看语义:ConfirmButton 可以表示“确认按钮”这个对象;但执行“确认购买/确认奖励”动作的节点应命名为 ConfirmBuy / ConfirmReward。
  • 入口节点常用 <Domain>Main;只编排流程、不直接识别或动作的节点常用 <Domain><Subtask>Flow,若流程目标本身是动作,也可用动宾目标,例如 DailyRewardsClaimRewardFlow。
  • 页面或 UI 状态节点使用 On<Page>Page、Visible、Available、Selected、Completed、Exhausted 等能表达业务语义的后缀。
  • 不要使用 _Start、Node1、clickReward、shop_enter、FlagInX、RewardConfirm、RewardClaim、GemPurchase、PageClose 这类不稳定、语序不一致或不表达职责的名称。

Pipeline v2 推荐格式

jsonc
{
    "MyNode": {
        "recognition": {
            "type": "TemplateMatch",
            "param": {
                "template": "MyTask/button.png",
                "roi": [100, 200, 300, 100],
                "threshold": 0.7,
            },
        },
        "action": {
            "type": "Click",
        },
        "next": ["NextNode"],
    },
}

常用识别算法

TemplateMatch
jsonc
"recognition": {
    "type": "TemplateMatch",
    "param": {
        "template": "path/to/image.png",
        "roi": [x, y, w, h],
        "threshold": 0.7
    }
}
  • 模板路径通常相对项目 image/resource 图片目录,按当前项目约定为准。
  • 尽量缩小 ROI,避免全屏匹配造成性能和误识别问题。
  • green_mask: true 可遮蔽不参与匹配的区域。
OCR
jsonc
"recognition": {
    "type": "OCR",
    "param": {
        "roi": [x, y, w, h],
        "expected": ["完整文本"]
    }
}
  • expected 优先写完整文本。
  • 多语言项目中,确认当前项目是否有 i18n 工具自动处理 OCR 文案。
  • 需要片段或正则时,按项目约定标注跳过 i18n。
ColorMatch
jsonc
"recognition": {
    "type": "ColorMatch",
    "param": {
        "roi": [x, y, w, h],
        "method": 40,
        "lower": [h_low, s_low, v_low],
        "upper": [h_high, s_high, v_high],
        "count": 100
    }
}
  • 优先使用 HSV 或灰度空间,避免直接 RGB 匹配带来的设备差异。
And / Or
jsonc
"recognition": {
    "type": "And",
    "param": {
        "all_of": ["NodeA", "NodeB"],
        "box_index": 0
    }
}
jsonc
"recognition": {
    "type": "Or",
    "param": {
        "any_of": ["NodeA", "NodeB"]
    }
}
  • 只有组合条件会被多个节点复用,或确实需要组合识别时,才拆出独立子节点。
  • 不要为了“看起来清楚”把单次使用的 Visible 节点过度拆分。
Custom
jsonc
"recognition": {
    "type": "Custom",
    "param": {
        "custom_recognition": "MyRecognition",
        "custom_recognition_param": {}
    }
}
  • custom_recognition / custom_action 名称必须与 Agent 注册名一致。
  • 参数结构应和 Go/C++/Python 扩展代码中的解析结构一致。

常用动作类型

动作用途关键字段
Click点击target, target_offset
LongPress长按target, duration
Swipe滑动begin, end, duration
Scroll滚轮target, dx, dy
ClickKey按键key
InputText输入文本input_text
StartApp / StopApp启停应用package
StopTask停止当前任务链无
Custom自定义动作custom_action, custom_action_param
DoNothing不执行动作无

target 常见形式:true、节点名字符串、[x, y]、[x, y, w, h]。

流程控制

  • next:按序识别,首个命中节点执行其 action 后成为当前节点;全部超时或为空则流程结束。
  • on_error:识别超时或动作失败后的兜底节点。
  • [JumpBack]:执行完子链后返回父节点继续识别,适合弹窗、加载、奖励确认等中断处理。
  • [Anchor]:动态引用锚点,按 MaaFramework 当前协议使用。
  • max_hit:限制节点最大命中次数,适合避免重复领取或循环点击。

典型模式

带弹窗处理的任务入口
jsonc
{
    "MyTaskMain": {
        "next": [
            "MyTaskStep",
            "[JumpBack]CommonConfirmDialog",
            "[JumpBack]CommonWaitLoadingExit",
            "[JumpBack]NavigationReturnHome",
        ],
    },
}
点击后验证画面变化
jsonc
{
    "ClickConfirm": {
        "recognition": {"type": "TemplateMatch", "param": {"template": "confirm.png", "roi": [100, 100, 200, 80]}},
        "action": {"type": "Click"},
        "post_wait_freezes": {"time": 200, "target": [0, 0, 0, 0]},
        "next": ["VerifyNextScreen", "[JumpBack]ClickConfirm"],
    },
}

审查清单

  • 字段名、类型、枚举值符合 Pipeline 协议或项目 schema。
  • next / on_error / sub / interrupt 引用的节点都存在。
  • 每次点击后有识别验证,不假设操作后状态。
  • ROI / target 坐标基于 1280×720 或项目约定分辨率。
  • 没有不必要的硬延迟;必须等待时优先使用 freeze wait。
  • OCR 文本和 locale/i18n 规则符合当前项目约定。
  • Custom 节点注册名和参数结构与 Agent 代码一致。
  • 未过度拆分只使用一次且无复用价值的中转检测节点。

参考

© 1204244136, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .claude/skills/pipeline-guide of 1204244136/MDA.

  • SKILL.md
  • field-reference.md

Open the folder on GitHubat commit 90bb2b2

Compare with similar skills

Pipeline Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pipeline Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pipeline Guide this skill1204244136/MDA120—~1.4kAutomated safety check: PassAGPL-3.0
Pipeline GuideMaaEnd/MaaEnd4k—~1.9kAutomated safety check: PassAGPL-3.0
Go Service GuideMaaEnd/MaaEnd4k—~2.1kAutomated safety check: PassAGPL-3.0
Maa Pipeline Guideduorua/narutomobile338—~3.4kAutomated safety check: PassAGPL-3.0
Cpp Algo StyleMaaEnd/MaaEnd4k—~2.3kAutomated safety check: PassAGPL-3.0
Maafwkqcoxn/MaaPipelineEditor408—~1.1kAutomated safety check: PassMIT

Similar skills

  • Pipeline Guide

    MaaEnd/MaaEnd

    MaaEnd Pipeline JSON 编写指南。基于 MaaFramework Pipeline 协议,提供节点命名、识别算法、动作类型、流程控制、可复用节点等编码规范与模式参考。在编写、修改或审查 Pipeline JSON、设计节点流程、使用 TemplateMatch/OCR/Custom 识别或 Click/Swipe 动作时使用。

    4k GitHub stars~1.9k tokensUpdated today
    MobileAuto-check passed
  • Go Service Guide

    MaaEnd/MaaEnd

    MaaEnd go-service 编写指南。为 agent/go-service/ 下的 Go 代码提供架构、注册、命名、日志、注释等编码规范和模式参考。在编写、修改或审查 Go 自定义识别器、动作、EventSink,或需要了解 go-service 项目结构与 MaaFramework Go 集成方式时使用。

    4k GitHub stars~2.1k tokensUpdated today
    MobileAuto-check passed
  • Maa Pipeline Guide

    duorua/narutomobile

    Universal Pipeline JSON 编写指南。基于 MaaFramework Pipeline 协议,提供节点命名、识别算法、动作类型、流程控制、可复用节点等编码规范与模式参考。在编写、修改或审查 Pipeline JSON、设计节点流程、使用 TemplateMatch/OCR/Custom 识别或 Click/Swipe 动作时使用。

    338 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Cpp Algo Style

    MaaEnd/MaaEnd

    MaaEnd cpp-algo C++ 编码风格与工程规范指南。参考 MaaFramework 的优秀实践,规范命名、头文件、公共工具、错误处理、日志、CMake 等方面。在编写、修改或审查 agent/cpp-algo/ 下的 C++ 代码时使用。

    4k GitHub stars~2.3k tokensUpdated today
    MobileAuto-check passed
  • Maafw

    kqcoxn/MaaPipelineEditor

    MaaFramework 开发与集成指南。当任务涉及 MaaFramework 项目结构、Pipeline 协议、ProjectInterface V2 协议、自定义识别/动作(Custom/Agent)、Python/NodeJS/CSharp 等语言 Binding 集成、控制器配置、回调协议或运行时行为时使用。

    408 GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Maa Logging

    MaaEnd/MaaEnd

    MaaFramework 日志宏用法指南,适用于 MaaEnd cpp-algo。Use when writing logging code, using LogInfo/LogError/LogWarn/LogDebug/LogTrace, outputting containers or custom types to logs, or when the user asks about…

    4k GitHub stars~807 tokensUpdated today
    MobileAuto-check passed

More from 1204244136/MDA

All 9 skills in this repo
  • Generate Pi Task

    1204244136/MDA

    根据 MaaFramework Pipeline 定义生成或更新 Project Interface 任务 JSON。用于创建、编辑或扩展 assets/tasks/ 下的任务文件,将 Pipeline 节点映射为用户可配置选项(switch/select/checkbox/input)并绑定 pipelineoverride。

    120 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Dmp Analysis

    1204244136/MDA

    分析 Windows 崩溃转储文件(.dmp),诊断 MaaFramework / MXU 项目及其依赖项的崩溃。用于 issue 日志包或附件中发现 .dmp 文件,或用户要求分析 DMP / 崩溃转储时。

    120 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Go Service Guide

    1204244136/MDA

    MaaFramework Go Agent / go-service 编写指南。用于编写、修改或审查 agent/go-service/ 下的 Go 自定义识别器、动作、EventSink,或了解 MaaFramework Go Agent 的注册、日志、目录组织和参数解析模式。

    120 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Maa Logging

    1204244136/MDA

    MaaFramework C++ 日志宏用法指南。用于写 C++ MaaFramework 扩展、Custom 组件或工具代码时使用 LogInfo/LogError/LogWarn/LogDebug/LogTrace、VAR、容器输出和自定义类型日志。

    120 GitHub stars~790 tokensUpdated today
    Auto-check passed
  • 分析 MDA 公开 Issue、日志包或本地日志。用于 https://github.com/1204244136/MDA/issues/...、1234、MDA 日志压缩包、识别失败、任务卡死、控制器差异、Pipeline/Agent/MXU 问题。会从…

    120 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Mda Project Guide

    1204244136/MDA

    MDA 项目专属开发指南。用于在 MDA 中编写或审查 MaaFramework Pipeline、Project Interface 任务、locale、go-service 组件时补充项目结构、业务域、命名习惯和现有任务选项示例。与通用 pipeline-guide、pipeline-debug、generate-pi-task、go-service-guide 配合使用。

    120 GitHub stars~1.8k tokensUpdated today
    Auto-check passed

Questions about Pipeline Guide

What does Pipeline Guide do?

MaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON,设计节点流程,使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作,并检查 MaaFramework 项目的通用 Pipeline 可靠性。. Pipeline Guide is an agent skill from 1204244136/MDA.

How do I install Pipeline Guide in Claude Code?

Run `npx skills add 1204244136/MDA --skill pipeline-guide -a claude-code`. Or copy the skill folder (.claude/skills/pipeline-guide in 1204244136/MDA) into .claude/skills/pipeline-guide in your project. Claude Code loads it when a task matches its description.

How do I install Pipeline Guide in Codex?

Run `npx skills add 1204244136/MDA --skill pipeline-guide -a codex`. Or copy the skill folder (.claude/skills/pipeline-guide in 1204244136/MDA) into .agents/skills/pipeline-guide in your project. Codex loads it when a task matches its description.

Can I use Pipeline Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 1204244136/MDA --skill pipeline-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pipeline-guide, .gemini/skills/pipeline-guide, .github/skills/pipeline-guide and .opencode/skills/pipeline-guide in your project.

What does Pipeline Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Pipeline Guide is instructions for the agent only. Our summary lists: Python 3.

Does Pipeline Guide access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Pipeline Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pipeline Guide use?

Pipeline Guide is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pipeline Guide use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pipeline Guide?

Skills that share tags, products or a category with Pipeline Guide: Pipeline Guide (MaaEnd/MaaEnd, 4k stars), Go Service Guide (MaaEnd/MaaEnd, 4k stars), Maa Pipeline Guide (duorua/narutomobile, 338 stars) and Cpp Algo Style (MaaEnd/MaaEnd, 4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pipeline Guide?

1204244136 (a GitHub user) maintains it in 1204244136/MDA, which has 120 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 10, 2026.

Source: 1204244136/MDA on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.