Skip to content

AUTO-MAS-Project/AUTO-MAS / .agents/skills/mas-script-specialized-adapter

mas-script-specialized-adapter

Verified

Review, add, or refactor AUTO-MAS specialized script adapters by upstream architecture, including MAA, SRC, MaaEnd/MXU, General, ok-script adapters such as Okww and OkNte, multi-engine adapters such as HSR, and the one-dragon line such as BetterGI, as well as per-adapter issue-bundle exports. Use when lowering user setup friction, judging whether a change stays inside the black-box boundary (barrier first, then capability ownership), or changing ScriptType registration, task lifecycle, config ownership, ScriptConfig sessions, Electron integration, frontend edit surfaces, and verification.

references/guide.md

View on GitHub
# 专项适配 · 补充说明

主文档见 [SKILL.md](../SKILL.md);架构线判据见 [script-frontend-architectures.md](./script-frontend-architectures.md);实现规范见 [adapter-code-norms.md](./adapter-code-norms.md)。

本文件只补主文档没展开的两件事:为何以前端表面为专项单位、PR 拆分节奏。

## 为何以前端表面为专项单位

`ScriptType` 在后端对应 `app/task/<Name>/`,但在协作视角上贡献者主要新增/修改的是 Vue 表面,这些表面通过 Hub 分支与路由绑定到类型,形成稳定的「专项入口」:

```
用户操作 -> Scripts.vue (Hub) -> router -> EditView/* -> *UserEdit/*Section
                |
                +-> useScriptApi / useUserApi -> API -> config.py / task/Xxx
```

后端模块是实现细节:字段须与表单 `formData` 结构一致,但**不应先写 task 再补一个空壳前端**。反过来只改前端不落后端注册同样不完整——两侧应同 PR 打通。

## 交付前最小验收

- [ ] 答出本次改动消除了用户当前哪一步手工操作;若以补缺位立论,缺口属 MAS 领域且上游无任何等效入口
- [ ] 每个新增字段和按钮都有实际运行时消费者,无只存在于 schema 或表单的假功能
- [ ] 能力归属已判定(上游领域 / MAS 领域 / 上游私有格式),代码落点与事实来源唯一
- [ ] MAS 领域实现有失败提示、可回退行为、结束清理;上游执行的任务成败取自上游结果面,不静默误报成功
- [ ] 本地跑了对应最小专项测试;功能/bug 边界测试不随适配提交

## 推荐 PR 拆分

| 阶段 | 前端 | 后端 |
| --- | --- | --- |
| P0 | Hub + 路由 + Script/User Edit + Section 最小集 | 模型 + Manager + 注册表 |
| P1 | 计划表 / 队列 UI | plan / queue 分支 |
| P2 | 体验优化、预设、虚拟用户 | 可仅前端 |

## 参考 PR

[#133 MaaEnd](https://github.com/AUTO-MAS-Project/AUTO-MAS/pull/133) ·
[#152 计划表](https://github.com/AUTO-MAS-Project/AUTO-MAS/pull/152) ·
[#154 M9A(旧专项,#973 已并入 MFW,仅作历史参考)](https://github.com/AUTO-MAS-Project/AUTO-MAS/pull/154) ·
[727aafb SRC 风格](https://github.com/AUTO-MAS-Project/AUTO-MAS/commit/727aafbaf5e21fc81e85e795a5cd5b77ac508e60)
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall