Pipeline Guide
MaaEnd/MaaEnd
MaaEnd Pipeline JSON 编写指南。基于 MaaFramework Pipeline 协议,提供节点命名、识别算法、动作类型、流程控制、可复用节点等编码规范与模式参考。在编写、修改或审查 Pipeline JSON、设计节点流程、使用 TemplateMatch/OCR/Custom 识别或 Click/Swipe 动作时使用。
MaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON,设计节点流程,使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作,并检查 MaaFramework 项目的通用 Pipeline 可靠性。
$ npx skills add 1204244136/MDA --skill pipeline-guide -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install 1204244136/MDA pipeline-guide --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-srcUse ~/.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/
Install the "pipeline-guide" agent skill from https://github.com/1204244136/MDA/tree/main/.claude/skills/pipeline-guide into .claude/skills/pipeline-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pipeline-guide", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/1204244136/MDA/tree/main/.claude/skills/pipeline-guideType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add 1204244136/MDA --skill pipeline-guide -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install 1204244136/MDA pipeline-guide --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/1204244136/MDA.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/pipeline-guide .agents/skills/pipeline-guide && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "pipeline-guide" agent skill from https://github.com/1204244136/MDA/tree/main/.claude/skills/pipeline-guide into .agents/skills/pipeline-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pipeline-guide", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add 1204244136/MDA --skill pipeline-guide -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install 1204244136/MDA pipeline-guide --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/1204244136/MDA.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/pipeline-guide .cursor/skills/pipeline-guide && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "pipeline-guide" agent skill from https://github.com/1204244136/MDA/tree/main/.claude/skills/pipeline-guide into .cursor/skills/pipeline-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pipeline-guide", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/1204244136/MDA.git --path .claude/skills/pipeline-guide--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add 1204244136/MDA --skill pipeline-guide -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install 1204244136/MDA pipeline-guide --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/1204244136/MDA.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/pipeline-guide .gemini/skills/pipeline-guide && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "pipeline-guide" agent skill from https://github.com/1204244136/MDA/tree/main/.claude/skills/pipeline-guide into .gemini/skills/pipeline-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pipeline-guide", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install 1204244136/MDA pipeline-guideInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add 1204244136/MDA --skill pipeline-guide -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/1204244136/MDA.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/pipeline-guide .github/skills/pipeline-guide && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "pipeline-guide" agent skill from https://github.com/1204244136/MDA/tree/main/.claude/skills/pipeline-guide into .github/skills/pipeline-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pipeline-guide", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add 1204244136/MDA --skill pipeline-guide -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install 1204244136/MDA pipeline-guide --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/1204244136/MDA.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/pipeline-guide .opencode/skills/pipeline-guide && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "pipeline-guide" agent skill from https://github.com/1204244136/MDA/tree/main/.claude/skills/pipeline-guide into .opencode/skills/pipeline-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pipeline-guide", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
pipeline-guideMaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON,设计节点流程,使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作,并检查 MaaFramework 项目的通用 Pipeline 可靠性。
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.
5 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 90bb2b2. It shows what the files ask for, not the result of running them.
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.
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.
Links to these hosts (documentation or services it may open):
github.comFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
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.
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.
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.
The full file from 1204244136/MDA at commit 90bb2b2, republished under its AGPL-3.0 licence (© 1204244136). 202 words, ~1,428 tokens.
.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.next 列表,覆盖操作后可能出现的页面、弹窗、加载态和异常态。pre_delay / post_delay / timeout 解决稳定性问题,优先通过中间识别节点和 pre_wait_freezes / post_wait_freezes 等待画面稳定。<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。On<Page>Page、Visible、Available、Selected、Completed、Exhausted 等能表达业务语义的后缀。_Start、Node1、clickReward、shop_enter、FlagInX、RewardConfirm、RewardClaim、GemPurchase、PageClose 这类不稳定、语序不一致或不表达职责的名称。{
"MyNode": {
"recognition": {
"type": "TemplateMatch",
"param": {
"template": "MyTask/button.png",
"roi": [100, 200, 300, 100],
"threshold": 0.7,
},
},
"action": {
"type": "Click",
},
"next": ["NextNode"],
},
}"recognition": {
"type": "TemplateMatch",
"param": {
"template": "path/to/image.png",
"roi": [x, y, w, h],
"threshold": 0.7
}
}green_mask: true 可遮蔽不参与匹配的区域。"recognition": {
"type": "OCR",
"param": {
"roi": [x, y, w, h],
"expected": ["完整文本"]
}
}expected 优先写完整文本。"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
}
}"recognition": {
"type": "And",
"param": {
"all_of": ["NodeA", "NodeB"],
"box_index": 0
}
}"recognition": {
"type": "Or",
"param": {
"any_of": ["NodeA", "NodeB"]
}
}Visible 节点过度拆分。"recognition": {
"type": "Custom",
"param": {
"custom_recognition": "MyRecognition",
"custom_recognition_param": {}
}
}custom_recognition / custom_action 名称必须与 Agent 注册名一致。| 动作 | 用途 | 关键字段 |
|---|---|---|
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:限制节点最大命中次数,适合避免重复领取或循环点击。{
"MyTaskMain": {
"next": [
"MyTaskStep",
"[JumpBack]CommonConfirmDialog",
"[JumpBack]CommonWaitLoadingExit",
"[JumpBack]NavigationReturnHome",
],
},
}{
"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"],
},
}next / on_error / sub / interrupt 引用的节点都存在。© 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
SKILL.md and 1 other file in .claude/skills/pipeline-guide of 1204244136/MDA.
Open the folder on GitHubat commit 90bb2b2
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Pipeline Guide this skill1204244136/MDA | 120 | — | ~1.4k | Automated safety check: Pass | AGPL-3.0 | |
| Pipeline GuideMaaEnd/MaaEnd | 4k | — | ~1.9k | Automated safety check: Pass | AGPL-3.0 | |
| Go Service GuideMaaEnd/MaaEnd | 4k | — | ~2.1k | Automated safety check: Pass | AGPL-3.0 | |
| Maa Pipeline Guideduorua/narutomobile | 338 | — | ~3.4k | Automated safety check: Pass | AGPL-3.0 | |
| Cpp Algo StyleMaaEnd/MaaEnd | 4k | — | ~2.3k | Automated safety check: Pass | AGPL-3.0 | |
| Maafwkqcoxn/MaaPipelineEditor | 408 | — | ~1.1k | Automated safety check: Pass | MIT |
MaaEnd/MaaEnd
MaaEnd Pipeline JSON 编写指南。基于 MaaFramework Pipeline 协议,提供节点命名、识别算法、动作类型、流程控制、可复用节点等编码规范与模式参考。在编写、修改或审查 Pipeline JSON、设计节点流程、使用 TemplateMatch/OCR/Custom 识别或 Click/Swipe 动作时使用。
MaaEnd/MaaEnd
MaaEnd go-service 编写指南。为 agent/go-service/ 下的 Go 代码提供架构、注册、命名、日志、注释等编码规范和模式参考。在编写、修改或审查 Go 自定义识别器、动作、EventSink,或需要了解 go-service 项目结构与 MaaFramework Go 集成方式时使用。
duorua/narutomobile
Universal Pipeline JSON 编写指南。基于 MaaFramework Pipeline 协议,提供节点命名、识别算法、动作类型、流程控制、可复用节点等编码规范与模式参考。在编写、修改或审查 Pipeline JSON、设计节点流程、使用 TemplateMatch/OCR/Custom 识别或 Click/Swipe 动作时使用。
MaaEnd/MaaEnd
MaaEnd cpp-algo C++ 编码风格与工程规范指南。参考 MaaFramework 的优秀实践,规范命名、头文件、公共工具、错误处理、日志、CMake 等方面。在编写、修改或审查 agent/cpp-algo/ 下的 C++ 代码时使用。
kqcoxn/MaaPipelineEditor
MaaFramework 开发与集成指南。当任务涉及 MaaFramework 项目结构、Pipeline 协议、ProjectInterface V2 协议、自定义识别/动作(Custom/Agent)、Python/NodeJS/CSharp 等语言 Binding 集成、控制器配置、回调协议或运行时行为时使用。
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…
1204244136/MDA
根据 MaaFramework Pipeline 定义生成或更新 Project Interface 任务 JSON。用于创建、编辑或扩展 assets/tasks/ 下的任务文件,将 Pipeline 节点映射为用户可配置选项(switch/select/checkbox/input)并绑定 pipelineoverride。
1204244136/MDA
分析 Windows 崩溃转储文件(.dmp),诊断 MaaFramework / MXU 项目及其依赖项的崩溃。用于 issue 日志包或附件中发现 .dmp 文件,或用户要求分析 DMP / 崩溃转储时。
1204244136/MDA
MaaFramework Go Agent / go-service 编写指南。用于编写、修改或审查 agent/go-service/ 下的 Go 自定义识别器、动作、EventSink,或了解 MaaFramework Go Agent 的注册、日志、目录组织和参数解析模式。
1204244136/MDA
MaaFramework C++ 日志宏用法指南。用于写 C++ MaaFramework 扩展、Custom 组件或工具代码时使用 LogInfo/LogError/LogWarn/LogDebug/LogTrace、VAR、容器输出和自定义类型日志。
1204244136/MDA
分析 MDA 公开 Issue、日志包或本地日志。用于 https://github.com/1204244136/MDA/issues/...、1234、MDA 日志压缩包、识别失败、任务卡死、控制器差异、Pipeline/Agent/MXU 问题。会从…
1204244136/MDA
MDA 项目专属开发指南。用于在 MDA 中编写或审查 MaaFramework Pipeline、Project Interface 任务、locale、go-service 组件时补充项目结构、业务域、命名习惯和现有任务选项示例。与通用 pipeline-guide、pipeline-debug、generate-pi-task、go-service-guide 配合使用。
MaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON,设计节点流程,使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作,并检查 MaaFramework 项目的通用 Pipeline 可靠性。. Pipeline Guide is an agent skill from 1204244136/MDA.
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.
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.
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.
SKILL.md names no scripts, command-line tools or credentials: Pipeline Guide is instructions for the agent only. Our summary lists: Python 3.
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
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.
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.
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.
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.
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.