Agent skill

Mda Project Guide

by 1204244136 in 1204244136/MDA

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

AGPL-3.0Auto-check passedFrontend & Design

Install Mda Project Guide

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

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

GitHub CLI
$ gh skill install 1204244136/MDA mda-project-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/mda-project-guide .claude/skills/mda-project-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
mda-project-guide
GitHub stars
119
Token cost
~1.8k tokens
SKILL.md length
398 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
AGPL-3.0

At a glance

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

  • Frontend & Design work in your project
  • SKILL.md covers 适用范围, 项目结构, MDA locale 范围 and 常见业务域, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

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

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design. The repository describes itself as: Nikke小助手 | Assistant For Goddess of Victory: Nikke. The licence is AGPL-3.0.

When your agent uses it

  • Frontend & Design work in your project

Example prompts

  • “/mda-project-guide”

What it can do on your machine

Read from SKILL.md and the folder at commit 9fb9b48. 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 json).

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

  • Network

    No URLs in SKILL.md.

    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

Mda Project Guide loads about 1.8k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 398 words of instructions outside code blocks.

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

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 9fb9b48, republished under its AGPL-3.0 licence (© 1204244136). 398 words, ~1,830 tokens.

Download SKILL.mdSave it as .claude/skills/mda-project-guide/SKILL.md (or your agent's skills folder).
name
mda-project-guide
description
MDA 项目专属开发指南。用于在 MDA 中编写或审查 MaaFramework Pipeline、Project Interface 任务、locale、go-service 组件时补充项目结构、业务域、命名习惯和现有任务选项示例。与通用 pipeline-guide、pipeline-debug、generate-pi-task、go-service-guide 配合使用。

MDA 项目指南

适用范围

当你正在 C:\Users\12042\Documents\GitHub\MDA 仓库中工作,并且任务涉及以下内容时使用本 skill:

  • Pipeline JSON 编写、调试或命名。
  • Project Interface 任务文件生成或修改。
  • assets/interface.json、assets/tasks/、assets/locales/interface/。
  • MDA 的 agent/go-service/ 自定义组件。
  • 需要判断 MDA 现有业务域、任务选项、locale 语言范围或路径约定。

本 skill 只记录 MDA 项目特例;MaaFramework 通用规则请先看:

  • pipeline-guide
  • pipeline-debug
  • generate-pi-task
  • go-service-guide

项目结构

MDA 采用 MaaFramework / Project Interface / MXU 风格结构:

text
MDA/
├── AGENTS.md
├── assets/
│   ├── interface.json
│   ├── tasks/
│   ├── locales/interface/
│   │   ├── zh_cn.json
│   │   └── en_us.json
│   ├── locales/go-service/
│   │   ├── zh_cn.json
│   │   └── en_us.json
│   └── resource/pipeline/
├── agent/go-service/
└── tools/schema/

关键文件:

路径用途
assets/interface.jsonProject Interface 主配置,包含 import、group、controller、resource 等
assets/tasks/*.jsonPI 任务定义和 option 配置
assets/tasks/preset/*.json预设任务组合
assets/resource/pipeline/**.jsonMaaFramework Pipeline 节点
assets/locales/interface/zh_cn.json界面中文文案
assets/locales/interface/en_us.json界面英文文案
tools/schema/*.jsonPipeline / PI / Custom schema
agent/go-service/Go Agent 自定义逻辑

MDA locale 范围

MDA 当前 interface locale 主要维护:

  • zh_cn
  • en_us

新增任务或 option 时,默认只同步这两个文件。不要按其它项目习惯擅自补 zh_tw、ja_jp、ko_kr,除非用户明确要求或项目新增了对应 locale 文件。

所有用户可见文本在任务文件中使用 $ i18n key,例如:

json
"label": "$task.Shop.label"

常见业务域

MDA Pipeline 当前常见业务域包括:

Domain说明
Advise咨询 / 剧情 / 剧集相关
Arena竞技场相关
Battle战斗通用流程
Common通用 UI、弹窗、交互
CoordinatedOperations协同作战
DailyRewards日常奖励
Event活动通用域
Interception拦截战
Login登录流程
MapPushing推图
Navigation导航和回到主界面
Outpost前哨基地
RedDotClear红点清理
Shop商店
SimulationRoom模拟室
TribeTower企业塔 / 阵营塔

新增节点时优先沿用现有目录与 Domain;不要为了单个节点新建同义 Domain。

Pipeline 命名习惯

MDA 使用通用 MaaFramework PascalCase 命名规则,并倾向于:

  • 入口:<Domain>Main
  • 编排:<Domain><Subtask>Flow
  • 进入页面:<Domain>Enter<Page>
  • 页面确认:<Domain><Page>Entered
  • 页面状态:<Domain>On<Page>Page
  • UI 可见:<Domain><Object>Visible
  • 点击/选择/领取:<Domain>Click<Object>、Select、Claim、Purchase
  • 确认:<Domain>Confirm<Object> 或 CommonConfirm<Object>

MDA 命名中特别注意:

  • 新节点不要再用 FlagInX 表达页面状态。
  • Visible 节点不要过度拆分;如果只被一个点击节点使用且没有组合识别价值,优先合并进点击节点。
  • Entered 节点可以只被一个进入流程引用,只要它承担“进入成功哨兵”职责,就不是无意义中转节点。

Project Interface 任务文件

MDA 任务文件位于 assets/tasks/,当前包括:

  • Advise.json
  • Arena.json
  • CashShop.json
  • CoordinatedOperations.json
  • DailyRewards.json
  • Interception.json
  • LargeEvent.json
  • MapPushing.json
  • Outpost.json
  • RedDotClear.json
  • Shop.json
  • SimulationRoom.json
  • SmallEvent.json
  • TribeTower.json

新增任务文件后,assets/interface.json 的 import[] 使用相对路径:

json
"tasks/MyTask.json"

而不是:

json
"assets/tasks/MyTask.json"

MDA 选项建模示例

这些例子来自 MDA 现有任务,用于辅助判断 generate-pi-task 的 option 类型。

Task FileOptionType说明
Arena.jsonSpecialRewardswitch单个是否领取奖励的开关
Arena.jsonEnterRookieArenaswitch单个是否进入该竞技场的开关
Interception.jsonInterceptionTypeselectNormal / Anomaly 互斥
Interception.jsonNormalyInterceptionLevelnested select普通拦截的难度子选项
Interception.jsonAnomalyInterceptionTargetnested select异常拦截的目标子选项
Interception.jsonManualInterceptionBattleswitch单个功能开关
Shop.jsonArenaShopItemListcheckbox多个独立商店物品可同时购买
Shop.jsonRecyclingShopListcheckbox多个独立可回收物品,存在默认选择
Shop.jsonCommonShopFreeGoodsswitch单个是否领取免费商品开关
SimulationRoom.jsonStartOverlockswitchYes case 下嵌套 AutoBIOSSetting
SimulationRoom.jsonAutoBIOSSettingnested switch自动难度子开关
Outpost.jsonDefenseRewardsswitch默认开启时可设置 default_case: "Yes"
TribeTower.jsonEnterCommonTowerswitch默认关闭时可按既有风格让 No 在 Yes 前

判断原则:

  • select:互斥路线,case 之间要互相禁用。
  • checkbox:独立列表,case 通常只启用自身节点。
  • switch:单个是否执行的功能。
  • nested option:只有某个 case 激活后才显示的子配置。
Show full SKILL.md (119 more words)Show less

MDA Go Service

MDA 存在 agent/go-service/,当前包含:

  • main.go
  • register.go
  • logger.go
  • pkg/pienv
  • pkg/resource
  • pkg/i18n
  • pkg/maafocus
  • taskersink/aspectratio
  • taskersink/hdrcheck
  • taskersink/processcheck
  • taskersink/membership

开发 Go 组件时:

  • 先看 agent/go-service/register.go 的聚合方式。
  • 新包应有自己的 Register()。
  • 注册名必须与 Pipeline Custom 节点一致。
  • 日志和包结构遵循当前已有 Go 代码。
  • 如果新增用户可见文案,同时维护 assets/locales/go-service/zh_cn.json 和 en_us.json。

Windows / PowerShell 约束

MDA 的 AGENTS.md 明确项目运行环境为 Windows / PowerShell 7。

执行命令时:

  • 优先使用 PowerShell 语法。
  • 路径带空格时加双引号。
  • 不要默认使用 Bash heredoc、grep、find、sed、awk 等 Unix 写法。
  • 文件搜索和读取优先使用 Claude Code 专用工具。

与通用 skill 的配合方式

  • 写 Pipeline:先用 pipeline-guide,再用本 skill 确认 MDA Domain、locale 范围和任务结构。
  • 调试 Pipeline:先用 pipeline-debug,再用本 skill 判断 MDA 现有命名和任务语义。
  • 生成 PI task:先用 generate-pi-task,再用本 skill 参考 MDA 选项建模示例。
  • 写 Go Service:先用 go-service-guide,再用本 skill 确认 MDA 的包和 locale 目录。

自检清单

  • 新增/修改的任务文件已被 assets/interface.json import。
  • 只维护 MDA 当前存在的 interface locale:zh_cn、en_us。
  • Pipeline 节点 Domain 与现有目录和业务域一致。
  • option 类型符合 MDA 既有建模习惯。
  • pipeline_override 节点名真实存在。
  • Go 组件已注册到 registerAll()。

© 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

Just SKILL.md in .claude/skills/mda-project-guide of 1204244136/MDA.

Open the folder on GitHubat commit 9fb9b48

Compare with similar skills

Mda Project 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.

Mda Project Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mda Project Guide this skill1204244136/MDA119—~1.8kAutomated safety check: PassAGPL-3.0
Web Artifacts Builderanthropics/skills180k41 repos~769Automated safety check: PassApache-2.0
React Doctormakeplane/plane61k12 repos~657Automated safety check: PassAGPL-3.0
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Figma Design System Builderwarpdotdev/warp65k2 repos~4.4kAutomated safety check: PassAGPL-3.0
Web Interface Guidelines Reviewervercel-labs/openreview1.7k98 repos~308Automated safety check: PassNone

Similar skills

  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 41 repos~769 tokens
    Frontend & DesignAuto-check passed
  • React Doctor

    makeplane/plane

    Scans React code for lint, accessibility, bundle size and architecture issues, reports a health score and checks that changes do not lower it.

    61k GitHub starsUsed in 12 repos~657 tokens
    Frontend & DesignAuto-check passed
  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Web Interface Guidelines Reviewer

    vercel-labs/openreview

    Official

    Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…

    1.7k GitHub starsUsed in 98 repos~308 tokens
    Frontend & DesignAuto-check passed
  • Tailwindcss Development

    anonaddy/anonaddy

    Always invoke when the user's message includes 'tailwind' in any form.

    4.9k GitHub starsUsed in 10 repos~865 tokens
    Frontend & DesignAuto-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。

    119 GitHub stars~1k tokensUpdated 3 days ago
    Auto-check passed
  • Dmp Analysis

    1204244136/MDA

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

    119 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Go Service Guide

    1204244136/MDA

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

    119 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Maa Logging

    1204244136/MDA

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

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

    119 GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed
  • Meojson

    1204244136/MDA

    meojson C++ JSON 库使用指南。用于 MaaFramework C++ 项目中的 JSON 解析、序列化、MEOJSONIZATION、json::value 操作、ext::jsonization 自定义类型支持,以及 Custom 参数解析。

    119 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed

Questions about Mda Project Guide

What does Mda Project Guide do?

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

When should I use Mda Project Guide?

Mda Project Guide fits situations like: frontend & Design work in your project.

How do I install Mda Project Guide in Claude Code?

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

How do I install Mda Project Guide in Codex?

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

Can I use Mda Project 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 mda-project-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/mda-project-guide, .gemini/skills/mda-project-guide, .github/skills/mda-project-guide and .opencode/skills/mda-project-guide in your project.

What does Mda Project Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Mda Project Guide is instructions for the agent only.

Does Mda Project Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Mda Project 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 Mda Project Guide use?

Mda Project 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 Mda Project Guide use?

About 1.8k tokens (SKILL.md is roughly 7.3k 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 Mda Project Guide?

Skills that share tags, products or a category with Mda Project Guide: Web Artifacts Builder (anthropics/skills, 180k stars), React Doctor (makeplane/plane, 61k stars), Impeccable (bestofjs/bestofjs, 3.1k stars) and Figma Design System Builder (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mda Project Guide?

1204244136 (a GitHub user) maintains it in 1204244136/MDA, which has 119 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 5, 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.