AUTO-MAS-Project/AUTO-MAS / .agents/skills/mas-script-specialized-adapter
mas-script-specialized-adapter
VerifiedReview, 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 22.4 KB |
| references/adapter-code-norms.md | markdown | 12.4 KB |
| references/blackbox-boundary.md | markdown | 8.9 KB |
| references/config-archive.md | markdown | 17.7 KB |
| references/config-restore.md | markdown | 42.1 KB |
| references/examples-baah.md | markdown | 12.3 KB |
| references/examples-bettergi.md | markdown | 7.4 KB |
| references/examples-hsr.md | markdown | 16.6 KB |
| references/examples-m9a.md | markdown | 1.0 KB |
| references/examples-maaend.md | markdown | 4.4 KB |
| references/examples-oknte.md | markdown | 4.3 KB |
| references/examples-okww.md | markdown | 10.6 KB |
| references/examples-src.md | markdown | 4.9 KB |
| references/examples-whimbox.md | markdown | 13.8 KB |
| references/examples-zzzod.md | markdown | 33.9 KB |
| references/guide.md | markdown | 2.2 KB |
| references/issue-report.md | markdown | 2.6 KB |
| references/logbox-api.md | markdown | 22.7 KB |
| references/ocr-tools.md | markdown | 3.6 KB |
| references/script-frontend-architectures.md | markdown | 7.2 KB |
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)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |