القائمة
MDA 项目专属开发指南。用于在 MDA 中编写或审查 MaaFramework Pipeline、Project Interface 任务、locale、go-service 组件时补充项目结构、业务域、命名习惯和现有任务选项示例。与通用 pipeline-guide、pipeline-debug、generate-pi-task、go-service-guide 配合使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
调试和优化 MaaFramework Pipeline JSON。用于对照 schema 验证配置，检测缺失引用、循环依赖、孤立节点、命名与行为不匹配、ROI/阈值问题，并给出可靠性、性能和可维护性改进建议。触发词包括 debug pipeline、validate pipeline、optimize pipeline、pipeline error。
MaaFramework Pipeline JSON 编写指南。用于编写、修改或审查 Pipeline JSON，设计节点流程，使用 TemplateMatch/OCR/ColorMatch/Custom 识别或 Click/Swipe/Custom 动作，并检查 MaaFramework 项目的通用 Pipeline 可靠性。
分析 Windows 崩溃转储文件（.dmp），诊断 MaaFramework / MXU 项目及其依赖项的崩溃。用于 issue 日志包或附件中发现 .dmp 文件，或用户要求分析 DMP / 崩溃转储时。
根据 MaaFramework Pipeline 定义生成或更新 Project Interface 任务 JSON。用于创建、编辑或扩展 assets/tasks/ 下的任务文件，将 Pipeline 节点映射为用户可配置选项（switch/select/checkbox/input）并绑定 pipeline_override。
MaaFramework C++ 日志宏用法指南。用于写 C++ MaaFramework 扩展、Custom 组件或工具代码时使用 LogInfo/LogError/LogWarn/LogDebug/LogTrace、VAR、容器输出和自定义类型日志。
分析 MDA 公开 Issue、日志包或本地日志。用于 `https://github.com/1204244136/MDA/issues/...`、`#1234`、MDA 日志压缩包、识别失败、任务卡死、控制器差异、Pipeline/Agent/MXU 问题。会从 maafw.log、maafw.bak.*.log、go-service.log、mxu-tauri.log、mxu-web-*.log、mxu-agent*.log、config/*、on_error/ 中筛选证据，并结合 MDA、MaaFramework、MXU 代码和文档判断根因。
| name | mda-project-guide |
| description | MDA 项目专属开发指南。用于在 MDA 中编写或审查 MaaFramework Pipeline、Project Interface 任务、locale、go-service 组件时补充项目结构、业务域、命名习惯和现有任务选项示例。与通用 pipeline-guide、pipeline-debug、generate-pi-task、go-service-guide 配合使用。 |
当你正在 C:\Users\12042\Documents\GitHub\MDA 仓库中工作，并且任务涉及以下内容时使用本 skill：
assets/interface.json、assets/tasks/、assets/locales/interface/。agent/go-service/ 自定义组件。本 skill 只记录 MDA 项目特例；MaaFramework 通用规则请先看：
pipeline-guidepipeline-debuggenerate-pi-taskgo-service-guideMDA 采用 MaaFramework / Project Interface / MXU 风格结构：
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.json | Project Interface 主配置，包含 import、group、controller、resource 等 |
assets/tasks/*.json | PI 任务定义和 option 配置 |
assets/tasks/preset/*.json | 预设任务组合 |
assets/resource/pipeline/**.json | MaaFramework Pipeline 节点 |
assets/locales/interface/zh_cn.json | 界面中文文案 |
assets/locales/interface/en_us.json | 界面英文文案 |
tools/schema/*.json | Pipeline / PI / Custom schema |
agent/go-service/ | Go Agent 自定义逻辑 |
MDA 当前 interface locale 主要维护：
zh_cnen_us新增任务或 option 时，默认只同步这两个文件。不要按其它项目习惯擅自补 zh_tw、ja_jp、ko_kr，除非用户明确要求或项目新增了对应 locale 文件。
所有用户可见文本在任务文件中使用 $ i18n key，例如：
"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。
MDA 使用通用 MaaFramework PascalCase 命名规则，并倾向于：
<Domain>Main<Domain><Subtask>Flow<Domain>Enter<Page><Domain><Page>Entered<Domain>On<Page>Page<Domain><Object>Visible<Domain>Click<Object>、Select、Claim、Purchase<Domain>Confirm<Object> 或 CommonConfirm<Object>MDA 命名中特别注意：
FlagInX 表达页面状态。Visible 节点不要过度拆分；如果只被一个点击节点使用且没有组合识别价值，优先合并进点击节点。Entered 节点可以只被一个进入流程引用，只要它承担“进入成功哨兵”职责，就不是无意义中转节点。MDA 任务文件位于 assets/tasks/，当前包括：
Advise.jsonArena.jsonCashShop.jsonCoordinatedOperations.jsonDailyRewards.jsonInterception.jsonLargeEvent.jsonMapPushing.jsonOutpost.jsonRedDotClear.jsonShop.jsonSimulationRoom.jsonSmallEvent.jsonTribeTower.json新增任务文件后，assets/interface.json 的 import[] 使用相对路径：
"tasks/MyTask.json"
而不是：
"assets/tasks/MyTask.json"
这些例子来自 MDA 现有任务，用于辅助判断 generate-pi-task 的 option 类型。
| Task File | Option | Type | 说明 |
|---|---|---|---|
Arena.json | SpecialReward | switch | 单个是否领取奖励的开关 |
Arena.json | EnterRookieArena | switch | 单个是否进入该竞技场的开关 |
Interception.json | InterceptionType | select | Normal / Anomaly 互斥 |
Interception.json | NormalyInterceptionLevel | nested select | 普通拦截的难度子选项 |
Interception.json | AnomalyInterceptionTarget | nested select | 异常拦截的目标子选项 |
Interception.json | ManualInterceptionBattle | switch | 单个功能开关 |
Shop.json | ArenaShopItemList | checkbox | 多个独立商店物品可同时购买 |
Shop.json | RecyclingShopList | checkbox | 多个独立可回收物品，存在默认选择 |
Shop.json | CommonShopFreeGoods | switch | 单个是否领取免费商品开关 |
SimulationRoom.json | StartOverlock | switch | Yes case 下嵌套 AutoBIOSSetting |
SimulationRoom.json | AutoBIOSSetting | nested switch | 自动难度子开关 |
Outpost.json | DefenseRewards | switch | 默认开启时可设置 default_case: "Yes" |
TribeTower.json | EnterCommonTower | switch | 默认关闭时可按既有风格让 No 在 Yes 前 |
判断原则：
select：互斥路线，case 之间要互相禁用。checkbox：独立列表，case 通常只启用自身节点。switch：单个是否执行的功能。MDA 存在 agent/go-service/，当前包含：
main.goregister.gologger.gopkg/pienvpkg/resourcepkg/i18npkg/maafocustaskersink/aspectratiotaskersink/hdrchecktaskersink/processchecktaskersink/membership开发 Go 组件时：
agent/go-service/register.go 的聚合方式。Register()。assets/locales/go-service/zh_cn.json 和 en_us.json。MDA 的 AGENTS.md 明确项目运行环境为 Windows / PowerShell 7。
执行命令时：
grep、find、sed、awk 等 Unix 写法。pipeline-guide，再用本 skill 确认 MDA Domain、locale 范围和任务结构。pipeline-debug，再用本 skill 判断 MDA 现有命名和任务语义。generate-pi-task，再用本 skill 参考 MDA 选项建模示例。go-service-guide，再用本 skill 确认 MDA 的包和 locale 目录。assets/interface.json import。zh_cn、en_us。pipeline_override 节点名真实存在。registerAll()。